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Web.py Cookbook 简体 中 文 版 
安装 
web.py 0.3 新 手指 南 


Hello World! 


提供 静态 文件 (诸如 js 脚本 , Css 样式 表 和 图 象 文件 ) 


理解 URL 控 制 
使 用 子 应 用 
提供 XML 访问 
从 post 读 取 原 始 数 据 

高 级 应 用 
web.ctx 
Application processors 
如 何 使 用 web.background 
自 定义 NotFound 消 息 
如 何 流 传输 大 文件 
管理 自 带 Webserver 日 志 
用 cherrypy 提 供 SSL 支 持 
实时 语言 切换 


Sessions and user state 会 话 和 用 户 状态 


Sessions 

在 调试 模式 下 使 用 Session 
在 template 中 使 用 session 
如 何 操作 Cookie 

用 户 认 证 


目录 


在 PostgreSQL 下 实现 用 户 认 证 


在 子 应 用 下 使 用 Session 
Utils 实用 工具 

发 送 邮 件 

如 何 用 Gmail 发 送 邮 件 

用 soaplib 实 现 webservice 
Templates 模板 

Templetor: web.py 模板 系统 

站 点 布局 模板 

交替 风格 
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Import functions into templates 7.4 
i18n support in template file 7.5 
在 webpy 中 使 用 Mako 模 板 引 擎 7.6 
在 webpy 中 使 用 Cheetah 模 板 引 车 7.7 
Use Jinja2 template engine in webpy 7.8 
How to use templates on Google App Engine 7.9 
Testing 测试 8 
Testing with Paste and Nose 8.1 
RESTful doctesting using app.request 8.2 
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File Upload Recipe 9.1 
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上 传 文件 大 小 限定 9.3 
web.input 9.4 
怎样 使 用 表单 forms 9.5 
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db.select 查询 10.2 
db.upate 数据 更 新 10.3 
db.delete 数据 删除 10.4 
db.insert 向 数据 库 中 新 增 数 据 10.5 
使 用 db.query 进 行 高 级 数据 库 查 询 10.6 
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整合 SQLite UDF (A ^ x X 4) 到 webpy 数据 库 层 10.9 
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Deployment 3f 4 11 
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来 源 : Web.py Cookbook 简体 中 文 版 


欢迎 来 到 web.py 0.3 的 Cookbook。 提 醒 您 注意 : 某 些 特性 在 之 前 的 版 本 中 并 不 可 
用 。 当 前 开发 版 本 是 0.3 © 


格式 
1. 在 编排 内 容 时 ， 请 尽量 使 用 cookbook 格 式 ... 如 : 
问题 : 如 何 访问 数据 库 中 的 数据 ? 


解法 : 使 用 如 下 代码 ,. 


2. 请 注意 ， 网 址 中 不 必 含 有 "Web"。 如 "/cookbook/select"， 而 
3E"Icookbook/web.select" ° 


3. 该 手册 适用 于 0.3 版 本 ， 所 以 您 在 添加 代码 时 ， 请 确认 代码 能 在 新 版 本 中 工作 。 


基本 应 用 : 


Hello World 

提供 静态 文件 访问 
理解 URL 控 制 

跳 转 与 重 定向 

使 用 子 应 用 

提供 XML 访问 

从 post 读 取 原 始 数据 


级 应 用 


I 


用 web.ctx 获 得 客户 端 信息 

应 用 处 理 器 ， 添 加 钓 子 种 载 钧 子 
如 何 使 用 web.background 

自 定 义 NotFound 信 息 

如 何 流传 输 大 文件 

对 自 带 的 webserver 日 志 进 行 操作 
用 cherrypy 提 供 SSL 支 持 

实时 语言 切换 
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Sessions and user state 会 话 和 用 户 状 态 : 


如 何 使 用 Session 

如 何在 调试 模式 下 使 用 Session 

在 template 中 使 用 session 

如 何 操作 Cookie 

用 户 认 十 

一 个 在 postgreSQL 数 据 库 环境 下 的 用 户 认证 的 例子 
如 何在 子 应 用 中 操作 Session 


Utils 实用 工具 : 


e 如何 发 送 邮 件 
e 如 何 利 用 Gmail 发 送 邮件 
e 使 用 soaplib 实 现 webservice 


Templates 模板 


Templetor: web.py 模板 系统 

使 用 站 点 布局 模板 

交替 式 风 格 (未 译 ) 

导入 函数 到 模板 中 (未 译 ) 

模板 文件 中 的 i18n 支 持 

在 web.py 中 使 用 Mako 模 板 引 擎 
在 web.py 中 使 用 Cheetah 模 板 引 擎 
在 web.py 中 使 用 Jinja2 模 板 引 擎 
如 何在 谷歌 应 用 程序 引擎 使 用 模板 


Testing 测试 : 


e Testing with Paste and Nose (未 译 ) 
e RESTful doctesting using an application's request method (#74) 


User input 用 户 输 入 : 


文件 上 传 

保存 上 传 的 文件 

上 传 文件 大 小 限定 

通过 web.input 接受 用 户 输 入 
怎样 使 用 表单 

显示 个 别 表 单字 段 
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Database 数据 库 


使 用 多 数据 库 

Select: 查询 数据 

Update: 更 新 数据 

Delete: 删除 数据 

Insert: 新 增 数 据 

Query: 高 级 数据 库 查 询 

怎样 使 用 数据 库 事 务 

使 用 sqlalchemy 

整合 SQLite UDF (A ^ x % 2) 到 webpy 数据 库 层 
1i Fl F 3 b A 4 where 4] 


Deployment 部 署 : 


通过 Fastcgi 和 lighttpd 部 署 

通过 Webpy 和 Nginx with FastCGI 搭 建 Web.py 

CGI deployment through Apache (未 译 ) 

mod_python deployment through Apache (requested) 
通过 Apache 和 mod _wsgi 部 署 

mod_wsgi deployment through Nginx (未 译 ) 

Fastcgi deployment through Nginx (未 译 ) 


Subdomains 子 域 名 : 


Subdomains and how to access the username (requested) 


Web.py Cookbook 简体 中 文 版 


安装 


Summary 
e UR 
e 开发 
e 产品 
o LightTPD 
a .. 使 用 FastCGI 
o Apache 
a .. 使 用 CGI 
a .. 使 用 CGI using .htaccess 
a .. 使 用 FastCGI 
a .. 使 用 SCGI 
a .. 使 用 mod python 
m .. 使 用 mod wsgi 
a .. 使 用 mod rewrite 


^ 
ye 


安装 web.py, HATA : 
http://webpy.org/static/web.py-0.37.tar.gz 
或 者 获取 最 新 的 开发 版 : 


https://github.com/webpy/webpy/tarball/master 


解压 并 拷贝 web 文件 夹 到 你 的 应 用 程序 目录 下 。 或者， 为 了 让 所 有 的 应 用 程序 都 
可 以 使 用 ， 运 行 : 


python setup.py install 
注意 : 在 某 些 类 unix 系 统 上 你 可 能 需要 切换 到 root 用 户 或 者 运行 : 


sudo python setup.py install 


查看 PARE. 


另外 一 个 选择 是 使 用 Easy Install. Easy Install 使 用 如 下 : 


easy_install web.py 


或 者 PIP 


sudo pip install web .py 


TA 


web.py 内 置 了 web 服 务 器 。 可 以 按照 tutorial 学 习 如 何 写 一 个 Web 应 用 。 写 完 后 ， 
将 你 的 代码 放 到 code.py 并 如 下 面 的 方法 来 启动 服务 器 : 


python code.py 


打开 你 的 浏览 器 输入 http://localhost:8080/ 查看 页 面 。 若 要 制定 另外 的 端口 ， 使 用 
python code.py 1234 ° 


产品 
现在 所 运行 Web.py 程序 的 web 服务 器 是 手 不 错 的 ， 但 绝 大 多 数 网 站 还 是 需要 更 加 
专业 一 些 的 Web 服务器 。web.py 实现 了 WSGI| 并 能 在 任何 兼容 它 的 服务 器 上 运 
行 。WSGI 是 一 个 web 服 务 器 与 应 用 程序 之 间 的 通用 APIl, 就 如 Java 的 Servlet 接 


口 。 你 需要 安装 flup (download here) 使 web.py 支持 with CGI > FastCGI 或 
SCGI，flup 提 供 了 这 些 API 的 WSGI| 接 口 。 


对 于 所 有 的 CGI 变量 ， 添 加 以 下 到 你 的 code.py : 
#!/usr/bin/env python 

并 运行 chmod +x code.py 添加 可 执行 属性 。 

LightTPD 


.. 使 用 FastCGI 


在 产品 中 通过 FastCGI 结 合 lighttpd 是 web.py 使 用 的 一 种 推荐 方法 。 reddit.com 通过 
该 方法 来 处 理 百 万 次 的 点 击 。 


lighttpd config 设 置 参考 如 下 : 


server.modules = ("mod fastcgi", "mod rewrite") 

server.document-root - "/path/to/root/" 

fastcgi.server = ( "/code.py" => 

(( "socket" => "/tmp/fastcgi.socket", 
"bin-path" -» "/path/to/root/code.py", 
"max-procs" => 1 

) ) 

) 


url.rewrite-once = ( 
"^/favicon.ico$" => "/static/favicon.ico", 
"A/static/(.')$" => "/static/$1", 
"A/(.*)$" => "/code.py/$1" 

) 


在 某 些 版 本 的 lighttpd 中 » 需要 保证 fastcgi.server 选 项 下 的 "check-local" 属 性 设置 
为 "false", 特别 是 当 你 的 code.py 不 在 文档 根 目 录 下 。 


如 果 你 得 到 错误 显示 不 能 够 导入 flup， 请 在 命令 行 下 输入 "easy install flup" 来 安 
X 。 

从 修订 版 本 145 开 始 ， 如 果 你 的 代码 使 用 了 重 定向 ， 还 需要 在 fastcgi 选 项 下 设置 
bin-environment 变 量 。 如 果 你 的 代码 重 定向 到 http://domain.com/ 而 在 url 栏 中 你 会 
看 到 http://domain.com/code.py/ ， 你 可 以 通过 设置 这 个 环境 变量 来 阻止 。 这 样 你 
的 fastcgi.server 设 置 将 会 如 下 : 


fastcgi.server = ( "/code.py" => 


(( 


"socket" -» "/tmp/fastcgi.socket", 
"bin-path" -» "/path/to/root/code.py", 
"max-procs" => 1, 
"bin-environment" => ( 

"REAL SCRIPT NAME" => "" 
), 


"check-local" => "disable" 


Apache 


.使 用 CGI 


添加 以 下 到 httpd.conf 或 apache2.conf 。 


Alias /foo/static/ /path/to/static 
ScriptAlias /foo/ /path/to/code. py 


.使 用 CGI .htaccess 


CGI 很 容易 配置 ， 但 不 适合 高 性 能 网 站 。 添加 以 下 到 你 的 .htaccess 


Options +ExecCGI 
AddHandler cgi-script .py 


将 你 的 浏览 器 指向 eS Ae d 。 不 要 忘记 最 后 的 斜 杠 ， 否 
则 你 将 会 看 到 not found 消息 (因为 在 urls 列表 中 你 输入 的 没有 被 匹配 到 ). 
为 了 让 其 dr s M code.py ， 局 用 mod rewrite 法 则 (查看 如 下 


o 


) 
注意 : web.py 的 实现 破坏 了 cgitb 模块 ， 因 为 它 截取 了 stdout » 可 以 通过 
以 下 的 方法 来 解决 该 问题 : 


import cgitb; cgitb.enable() 
import sys 
# ... import web etc here... 


def cgidebugerror(): 


_wrappedstdout = sys.stdout 


sys.stdout = web._oldstdout 
cgitb.handler() 


sys.stdout = _wrappedstdout 


web.internalerror = cgidebugerror 


E SS —— aay 





.使 用 FastCGI 
FastCGI 很 容易 配置 ， 运 行 方式 如 同 mod_ python ° 
添加 以 下 到 .htaccess 


<Files code.py> SetHandler fastcgi-script 
</Files> 


不 幸 的 是 ， T f& lighttpd, Apache" fé 4$ à zr 1% 49 web.py i A ZA FastCGI 服务 器 的 形 
式 工 作 ， 因 此 你 需要 明确 的 告诉 web.py。 添加 以 下 到 code.py 的 
if _name == " main _": 行 前 : 


web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(func, : 





«| 





SAR 8 o] E 25 48 9] gu (example) com/e ode hyd o Rmus 


i | 你 将 会 看 到 not found 消息 (因为 在 urls 列表 中 你 输入 的 没有 被 匹配 到 ). 


为 了 让 其 运行 的 时 候 不 需要 添加 code.py ， 尼 用 mod rewrite 法 则 (查看 如 下 )。 


Walter 还 有 一 些 额 外 建议 . 


.. 使 用 SCGI 


https://www.mems-exchange.org/software/scgi/ 从 http://www.mems- 
exchange.org/software/files/mod_scgi/ 下 载 mod_scgi 代码 windows apache 用 
户 : 编辑 httpd.conf : 


LoadModule scgi_module Modules/mod_scgi.so 
SCGIMount / 127.0.0.1:8080 


重启 apache， 并 在 命令 行 中 如 下 方式 启动 code.py : 
python code.py 127.0.0.1:8080 scgi 
打开 你 的 浏览 器 ， 访 问 127.0.0.1 It's ok! 


.. 使 用 mod python 
mod python 和 运行 方式 如 同 FastCGI ， 但 不 是 那么 方便 配置 
对 于 Python 2.5 按照 如 下 : 


cd /usr/lib/python2.5/wsgiref 

# or in windows: cd /python2.5/lib/wsgiref 

wget -O modpython gateway.py http://projects.amor.org/misc/browser, 
# or fetch the file from that address using your browser 





对 于 Python «2.5 按照 如 下 : 


cd /usr/lib/python2.4/site-packages 

# or in windows: cd /python2.4/lib/site-packages 

svn co svn://svn.eby-sarna.com/svnroot/wsgiref/wsgiref 

cd wsgiref 

wget -0 modpython_gateway.py http://projects.amor.org/misc/browser, 
# or fetch the file from that address using your browser 


‘ — Ę 








重 命名 code.py 为 codep.py 或 别 的 名 字 ， 添 加 : 


app = web.application(urls, globals() ) 
main = app.wsgifunc() 


在 htaccess 中 ， 添 加 : 


AddHandler python-program .py 
PythonHandler wsgiref.modpython gateway::handler 
PythonOption wsgi.application codep::main 


你 应 该 希望 添加 RewriteRule 将 / 指向 /codep.py/ 


确保 访问 /codep.py/ 的 时 候 有 添加 最 后 的 / 。 否则 ， 你 将 会 看 到 一 条 错误 信 
息 ， 比 如 A server error occurred. Please contact the Serene 


.使 用 mod_wsgi 

mod_wsgi 是 一 个 新 的 Apache 模 块 通常 优 于 mod python 用 于 架设 WSGI 应 用 ， 它 
非常 容易 配置 。 

在 code.py 的 最 后 添加 : 


app = web.application(urls, globals(), autoreload=False) 
application = app.wsgifunc() 


mod wsgi 提供 许多 可 行 方 法 来 实现 WSGI| 应 用 , 但 一 种 简单 的 方法 是 添加 以 下 到 
.htaccess : 


<Files code.py> 

SetHandler wsgi-script 

Options ExecCGI FollowSymLinks 
</Files> 


如 果 在 apache 的 error.log 文件 中 出 现 "ImportError: No module named web" > # 
导入 Web 之 前 ， 你 可 能 需要 在 code.py 中 尝试 设置 绝对 路 径 : 


import sys, os 

abspath = os.path.dirname( (file ) 
sys.path.append(abspath) 
os.chdir(abspath) 

import web 


， 你 可 能 需要 查看 WSGI 应 用 的 常见 问题 的 "Application Working Directory" 


>» 


最 终 应 该 可 以 访问 http://example.com/code.py/ ° 


mod_rewrite 法 则 ，Apache 


WRAZ web.py 能 够 通过 'http:Wexample.com' 访问 ， 代 替 使 用 
'http://example.com/code.py/' ， 添 加 以 下 法 则 到 .htaccess 文件 : 


<IfModule mod_rewrite.c> 
RewriteEngine on 
RewriteBase / 
RewriteCond %{REQUEST_URI} !^/icons 
RewriteCond %{REQUEST_URI} !4/favicon.ico$ 
RewriteCond %{REQUEST_URI} !4(/.*)+code.py/ 
RewriteRule 4(.*)$ code.py/$1 [PT] 
</IfModule> 


如 果 code.py 在 子 目录 myapp/ f° A% RewriteBase A 
RewriteBase /myapp/ ° 如 果 还 有 一 些 静 态 文件 如 CSS 文 件 和 图 片 文件 , 复制 这 
些 并 改 成 你 需要 的 地 址 。 


web.py 0.3 新 手指 南 


开始 

URL 处 理 
GET 和 POST 的 区 别 
启动 服务 

模板 

表单 

数据 库 

开发 

下 一 步 做 什么 ? 


开始 
你 知道 Python 同时 你 希望 制作 一 个 网 站 。 那么 web.py 正 好 提供 了 一 种 简单 的 方 


如 果 你 希望 读 完 整个 指南 ， 你 需要 安装 Python, web.py, flup, psycopg2, 和 
Postgres (或 者 等 价 的 数据 库 和 Python 驱动 )。 详细 ， 可 以 查看 webpy.org. 


如 果 你 已 经 有 了 一 个 web.py 项 目 ， 请 看 看 升级 页 面 的 相关 信息 。 
准备 开始 。 


URL 处 理 


任何 网 站 最 重要 的 部 分 就 是 它 的 URL 结 构 。 你 的 URL 并 不 仅仅 只 是 访问 者 所 能 看 到 
并 且 能 发 给 朋友 的 。 它 还 规定 了 你 网 站 运行 的 心智 模型 。 在 一 些 类 似 del.icio.us 的 
流行 网 站 , URL 共 至 是 UI 的 一 部 分 。 Web.py 使 这 类 强大 的 URL 成 为 可 能 。 


在 开始 你 的 web.py 程 序 之 前 ,打开 一 个 文本 文件 (文件 名 为 code.py) 输入 : 
import web 

这 条 语句 会 导入 Web.py 模 块 。 

现在 我 们 需要 把 我 们 的 URL 结 构 告 诉 web.py。 让 我 从 下 面 这 个 简单 的 例子 开始 : 


urls = ( 
'/', 'index' 


) 


第 一 部 分 是 匹配 URL 的 正则 表达 式 ， 像 / > /help/faq > /item/(\d+) 等 

( \d+ 将 匹配 数字 ) 。 圆 括号 表示 捕捉 对 应 的 数据 以 便 后 面 使 用 。 第 二 部 分 是 接受 请 
求 的 类 名 称 ， 像 index 、 view 、 welcomes.hello ( welcomes 模块 

的 hello 类 )， 或 者 get_\1 ° Mà 会 被 正则 表达 式 捕捉 到 的 内 容 替 换 ， 剩 下 来 
捕捉 的 的 内 容 将 被 传递 到 你 的 函数 中 去 。 


这 行 表示 我 们 要 URL / (首页 ) 被 一 个 叫 index 的 类 处 理 。 
现在 我 们 需要 创建 一 个 列举 这 些 url 的 application 。 


app = web.application(urls, globals() ) 


这 会 告诉 web. Mus v 刚 提交 的 URL 列 表 的 application。 这 个 
application 会 在 这 个 文件 的 全 局 命名 空间 中 查找 对 应 类 。 


GET 和 POST: 区 别 


现在 我 们 需要 来 写 index 类 。 虽 然 大 多 数 人 只 会 看 看 ， 并 不 会 注意 你 的 浏览 器 在 
使 用 用 于 与 万 维 网 通信 的 HTTP 语 言 。 具 体 的 细节 并 不 重要 ， 但 是 要 理解 Web 访问 
者 请 求 Web 服 务 器 去 根据 URL( 像 / ` /foo?f=1 ) 执 行 一 个 合适 的 函数 

(4% GET 、 POST ) 的 基本 思想 。 


GET 是 我 们 都 熟悉 的 。 它 用 于 请 求 网 页 文本 。 当 你 在 浏览 器 输 

A harvard.edu ， 它 会 直接 访问 Harvard 的 Web 服务 器 ' X GET / œ 第 二 个 最 有 

名 的 是 POST ， 它 经 常 被 用 在 提交 form， 比 如 请 求 买 什 么 东西 。 每 当 提 交 一 个 去 做 

什么 事情 ( 像 使 用 信用 卡 处 理 一 笔 交 易 ) 的 请 求 时 ， 你 可 以 使 用 POST 。 这 是 关键 ， 

GET 的 URL 可 以 被 搜索 引擎 索引 ， 并 通过 搜索 引 敬 访问。 虽然 大 部 分 页 面 你 
望 被 索引 ， 但 是 少数 类 似 订 单 处 理 的 页 面 你 是 不 希望 被 索引 的 (想象 一 下 Google 

BUNC 网 站 上 的 所 有 东西 ) 。 


在 我 们 web.py 的 代码 中 ， 我 们 将 这 两 个 方法 明确 区 分 


class index: 
def GET(self): 
return "Hello, world!" 


当 有 人 用 GET HR / 时 ， 这 个 GET ibn ial o 
好 了 ， 限 制 我 们 只 需要 最 后 一 句 就 写 完 了 。 会 告诉 web.py 开 始 提供 web 页 面 


if | name == " main ": app.run() 


文 会 告诉 Web.py 为 我 们 启动 上 面 我 们 写 的 应 用 。 


现在 注意 ， 即 使 我 已 经 在 这 里 说 了 很 多 ， 但 我 们 真正 有 5 行 这 些 代 码 。 这 就 是 你 需 
要 编写 的 一 个 完整 的 web.py 应 用 。 为 了 更 方便 的 使 用 ， 你 的 完整 代码 应 该 像 下 面 
这 样 : 


import web 
urls = ( 


'/', 'index' 
) 


class index: 
def GET(self): 
return "Hello, world!" 


if _name__ == "__main_": 
app = web.application(urls, globals() ) 
app.run() 
启动 服务 


如 果 你 在 命令 行 下 面 ， 请 输入 :: $ python code.py http://0.0.0.0:8080/ 

现在 你 的 web.py 应 用 正 运 行 在 你 电脑 上 的 一 个 申 正 的 web 服 务 器 上 。 访问 那个 
URL， 然 后 你 应 该 看 到 "Hello, world!" (你 可 以 通过 把 IP 地 址 /端口 加 在 "code.py" 的 后 
面 ， 来 控制 Web.py 在 哪里 局 动 服务 器 。 你 也 可 以 让 它 运行 在 fastcgi 或 scgi 服 
务 器 上 )。 


注意 : 如 果 你 不 能 或 者 不 想 使 用 默认 端口 ， 你 可 以 使 用 这 样 的 命令 来 指定 端口 号 : 


$ python code.py 1234 


模板 


在 Python 中 写 HTML 不 是 聪明 的 选择 ， 相 反 在 HTML ¥ 5 Python 则 有 趣 的 多 。 
幸运 的 是 ， web.py 让 这 件 事 情 做 得 简单 而 又 漂亮 。 


注意 : 老 版 本 的 web.py 使 用 Cheetah 模板 系统 ， 你 可 以 也 欢迎 使 用 其 他 模板 
系统 ， 但 它 可 能 不 会 被 长 久 支 持 。 

给 模板 新 建 一 个 目录 (命名 为 templates ) ， 在 该 目录 下 新 建 一 个 以 ,html 
结尾 的 文件 ， 内 容 如 下 : 


<em>Hello</em>, world! 


你 也 可 以 在 模板 中 使 用 web.py 模板 支持 代码 : 


$def with (name) 
$if name: 


I just wanted to say <em>hello</em> to $name. 
$else: 


<em>Hello</em>, world! 


如 上 ， 该 模板 看 起 来 就 像 python 文件 一 样 ， 除 了 顶部 的 def with (表示 从 模板 
将 从 这 后 面 取 值 ) 和 总 是 位 于 代码 段 之 前 的 $ 。 当 前 ， template.py 首先 请 求 模 
板 文件 的 首 行 $def 。 当 然 ， 你 要 注意 web.py 将 会 转 义 任何 任何 用 到 的 变 

量 ， 所 以 当 你 将 name 的 值 设 为 是 一 段 HTML 时 ， 它 会 被 转 义 显示 成 纯 文本 。 如 
果 要 关闭 该 选项 ， 可 以 写成 $:name 来 代替 $name ° 


回 看 再 看 code.py 。 在 第 一 行 之 下 添加 : 


render = web.template.render('templates/' ) 


这 会 告诉 web.py 到 你 的 模板 目录 中 去 查找 模板 。 然 后 把 index.GET KA: 告诉 
web.py 在 你 的 模板 目录 下 查找 模板 文件 。 人 和 修改 index.GET 


name = 'Bob' 
return render.index(name) 


(index! 是 模板 的 名 字 ，'name' 是 传 入 模板 的 一 个 参数 ) 
访问 站 点 它 将 显示 hello Bob 。 


但 是 如 果 我 们 想 让 用 户 自行 输入 他 的 名 字 ， 么 办 ?如 下 : 


i = web.input(name=None) 
return render.index(i.name) 


访问 / 将 显示 hello world， 访 问 /?name=Joe 将 显示 hello Joe ° 


URL 的 后 面 的 ? 看 起 来 不 好 看 ?修改 下 URL 配置 : 
'/(.*)', 'index' 
然后 修改 下 index.GET 


def GET(self, name): 
return render.index(name) 


现在 访问 /Joe 看 看 ， 它 会 显示 hello Joe 。 


如 果 学 习 更 多 关于 web.py 的 模板 处 理 ， 请 访问 web.py 模板 . 


web. py 的 form 模 块 能 够 帮助 你 生成 HTML 表 单 ; 获取 用 户 的 输入 ， 并 在 处 理 或 添加 
到 数据 库 之 前 对 其 进行 内 容 的 验证 。 如 果 你 要 学 习 更 多 关于 form 模 块 的 使 用 ， 请 查 
看 帮助 文档 或 者 Form 类 库 的 链接 


数据 库 操作 


注意 : 在 你 开始 使 用 数据 库 之 前 ， 确 保 你 已 经 安装 了 合适 的 数据 库 访问 库 。 比 如 对 
于 MySQL 数 据 库 ， ， 使 用 MySQLdb ， 对 于 Postgres 数 据 库 使 用 psycopg2。 


首先 你 需要 创建 一 个 数据 库 对 象 。 


db = web.database(dbn='postgres', user='username', pw='password', ( 


a 





(根据 需要 修改 这 里 -- KH username ^ password ^ dbname -- ° 
MySQL 用 户 还 需要 把 dbn CLARA mysql °) 


这 就 是 所 有 你 需要 做 的 -- Web.py 将 会 自动 处 理 与 数据 库 的 连接 和 断 开 。 
使 用 的 的 数据 库 引 擎 管理 工具 ， 在 你 的 库 中 创建 一 个 简单 的 表 : 
CREATE TABLE todo ( 
id serial primary key, 
title text, 


created timestamp default now(), 
done boolean default 'f' Jr 


INSERT INTO todo (title) VALUES ('Learn web.py'); 


我 们 回来 继续 编辑 code.py ， 把 index.GET 改 成 下 面 的 样子 ， 替 换 整 个 函数 : 


def GET(self): 
todos = db.select('todo' ) 
return render.index(todos) 


然后 把 URL 列 表 改 回来 ， 只 保留 / : 


Of a cane. 


像 这 样 编辑 并 替换 index.html 的 全 部 内 容 


$def with (todos ) 
<ul> 
$for todo in todos: 
<li id="t$todo.id">$todo.title</1li> 
</ul> 


再 访问 你 的 网 站 ， 然 后 你 可 以 看 到 你 的 todo item: "Learn web.py" » #248 | 你 已 经 
数据 写 入 数据 库 的 程序 。 


在 index.html 尾部 添加 


<form method="post" action="add"> 
<p><input type="text" name="title" /> <input type="submit" value=" 
</form> 


a SO 
然后 把 你 的 URL 列 表 改 为 : 





dexa 
'/add', 'add' 


(你 必须 要 非常 小 心 那 些 过 号。 如果 你 省 略 他 们 ，Python 会 把 所 有 字符 串 连 接 起 来 ， 
变 成 '/index/addadd' ) 


现在 添加 另 一 个 类 : 
class add: 
def POST(self): 
i - web.input() 


n - db.insert('todo', title-i.title) 
raise web.seeother('/') 


(注意 现在 我 们 正在 使 用 POST ) 


web.input 可 以 让 你 访问 用 户 通 过 form 提 交 的 任何 数据 。 


注意 : 如 果 要 访问 多 个 相同 名 字 的 字段 ， 请 使 用 list 的 格式 (比如 :一 串 
name="name" 的 多 选 框 ): 


post_data=web.input(name=[ ] ) 


db.insert 把 数据 插入 数据 表 todo ， 然 后 把 新 的 行 号 返回 给 你 。 
seeother 把 用 户 重 定向 到 指定 的 URL » 


一 些 快速 补充 说 明 : db.update 与 db.insert 差不多 ， 除 了 它 返 回 的 行 号 是 直 
接 从 sql 语 句 里面 提取 的 ( WHERE ID=2 )。 


web.input ^ db.query 已 经 其 他 web.py 中 的 函数 返 回 "Storage objects"， 这 此 
东西 就 像 字典 ， 你 除了 可 以 d['foo'] 之 外 ， 你 还 可 以 d.foo 。 这 可 以 让 代码 
更 加 干净 。 


你 可 以 在 the documentation 找 到 这 方面 具体 的 细节 以 及 所 有 web.py 的 函数 说 明 。 
开发 
web.py 还 有 一 些 帮助 我 们 debug 的 工具 。 当 它 在 内 建 的 服务 器 中 运行 时 ， 它 会 一 


debug 模 式 局 动 程序 。 在 debug 模 式 中 ， 任 何 代码 、 模 板 的 修改 ， 都 会 让 服务 器 重 
新 加 载 它们 ， 然 后 还 会 输出 有 用 的 错误 消息 。 


只 有 在 生产 环境 中 debug 模 式 是 关闭 的 。 如 果 你 想 禁用 debug 模 式 ， 你 可 以 在 创建 
程序 /模板 前 添加 像 这 样 的 行 。 


web.config.debug = False 
我 们 的 指南 就 到 这 里 了。 如果 要 做 更 多 很 酷 的 东西 ， 你 可 以 先 查看 一 下 文档 。 


下 一 步 是 什么 ? 


e 更 多 文档 
e Cookbook 
e code samples 


Hello World! 


问题 


如 何 用 web.py 实 现 Hello World! ? 
解法 


import web 


urls = ("/.*", "hello") 
app = web.application(urls, globals()) 


class hello: 
def GET(self): 
return 'Hello, world!' 


if name == "main ": 
app.run() 


提示 : 要 保证 网 址 有 无 多 结 尾 ， 都 能 指向 同一 个 类 。 就 要 多 写 几 
行 代码 ， 如 下 : 
在 URL 开 头 添加 代码 : 
(Ni y Acc pert nect 
然后 用 redirect 类 处 理 以 "结尾 的 网 址 : 


class redirect: 
def GET(self, path): 
web.seeother('/' + path) 


提供 静态 文件 (诸如 js 脚本 , CSS 样式 表 和 图 人 象 文件 ) 


问题 


如 何在 Web.py 自 带 的 web server 中 提供 静态 文件 访问 ? 
解法 


Web.py 服务 器 


在 当前 应 用 的 目录 下 ， 创 建 一 个 名 为 static 的 目录 ， 把 要 提供 访问 的 静态 文件 放 在 里 
面 即 可 。 


例如 , 网 址 http://localhost/static/logo.png 将 发 送 
./static/logo.png 给 客户 端 。 


Apache 


在 Apache 中 可 以 使 用 Alias 指令 ， 在 处 理 web.py 之 前 将 请 求 映射 到 指定 的 目录 。 
这 是 一 个 在 Unix like 系统 上 虚拟 主机 配置 的 例子 : 


<VirtualHost *:80> 
ServerName example.com:80 
DocumentRoot /doc/root/ 
# mounts your application if mod_wsgi is being used 
WSGIScriptAlias / /script/root/code. py 
# the Alias directive 
Alias /static /doc/root/static 


<Directory /> 
Order Allow, Deny 
Allow From All 
Options -Indexes 
</Directory> 


# because Alias can be used to reference resources outside doci 
# must reference the directory with an absolute path 
«Directory /doc/root/static> 
# directives to effect the static directory 
Options +Indexes 
«/Directory» 
</VirtualHost> 


«| = 
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理解 URL 控 制 


问题 : 如 何 为 整个 网 站 设计 一 个 URL 控 制 方案 / 调度 模式 
解决 : 


web.py 的 URL 控 制 模式 是 简单 的 、 强 大 的 、 灵 活 的 。 在 每 个 应 用 的 最 顶部 ， 你 通 
会 看 到 整个 URL 调 度 模 式 被 定义 在 元 组 中 : 


E 


urls - ( 
"/tasks/?", "signin", 
"/tasks/list", "listing", 
"/tasks/post", "post", 
"/tasks/chgpass", "chgpass", 
"/tasks/act", "actions", 
"/tasks/logout", "logout", 
"/tasks/signup", "signup" 


这 些 元 组 的 格式 是 : URL 路 径 , 处 理 类 这 组 定义 有 多 少 可 以 定义 多 少 。 如 果 你 并 不 知 
道 URL 路 径 和 处 理 类 类 之 间 的 关系 ， 请 在 阅读 cookbook 之 前 先 阅 读 Hello World 
example， 或 者 快速 入 门 。 


路 径 匹 配 
你 可 以 利用 强大 的 正则 表达 式 去 设计 更 灵活 的 URL 路 径 。 比 如 /ltest1ltest2) 可 以 捕 
提 /test1 或 /test2。 要 理解 这 里 的 关键 ， 匹 配 是 依据 URL 路 径 的 。 比 如 下 面 的 URL: 


http://localhost/myapp/greetings/hello?name=Joe 


这 个 URL 的 路 径 是 /myapp/greetings/hello。web.py 会 在 内 部 给 URL 路 径 加 上 ^ e$ 
' 这样 /tasks/ 不 会 匹配 /tasks/addnew ° URL ZZ Be tk #i ey ”， 所 以 不 能 这 样 使 
用 ， 如 : /tasks/delete?name-(.*) ,? 之 后 部 分 表示 是 “查询 ”， 并 不 会 被 匹配 。 阅 读 
URL 组 件 的 更 多 细节 ， 请 访问 web.ctx。 


捕捉 参数 
你 可 以 捕捉 URL 的 参数 ， 然 后 用 在 处 理 类 中 : 


/users/list/(.+), "list_users" 


在 list/ 后 面 的 这 块 会 被 捕 提 ， 然 后 作为 参数 被 用 在 GET 或 POST: 


class list_users: 
def GET(self, name): 
return "Listing info about user: {0}".format(name) 


你 可 以 根据 需要 定义 更 多 参数 。 同 时 要 注意 URL 查 询 的 参数 (? 后 面 的 内 容 ) 也 可 以 
用 web.input() 取 得 。 

开发 子 程序 的 时 候 注意 
为 了 更 好 的 控制 大 型 web 应 用 ，Web.py 支 持 子 程序 。 在 为 子 程序 设计 URL 模 式 的 时 
候 ， 记 住 取 到 的 路 径 (web.ctx.path) 是 父 应 用 剥离 后 的 。 比 如 ， 你 在 主 程序 定义 了 


URL"/blog" 跳 转 到 'blog' 子 程序 ， 那 没 在 你 blog 子 程序 中 所 有 URL 都 是 以 "开头 的 ， 
而 不 是 "/blog"。 查 看 Web.ctx 取 得 更 多 信息 。 


使 用 子 应 用 

问题 

如 何在 当前 应 用 中 包含 定义 在 其 他 文件 中 的 茶 个 应 用 ? 
解法 

在 blog.py 中 : 


import web 


urls = ( 

te "reblog", 

AD al Go ae "blog" 
) 


class reblog: 
def GET(self): raise web.seeother('/') 


class blog: 
def GET(self, path): 
return "blog " + path 


app blog - web.application(urls, locals()) 


当前 的 主 应 用 code.py : 


import web 

import blog 

urls = ( 
"/blog", blog.app_blog, 
(oe ys "index" 

) 

class index: 


def GET(self, path): 
return "hello " + path 


app - web.application(urls, locals()) 


if | name == "_ main_": 
app.run() 


提供 XML 访问 


问题 
如 何在 web.py 中 提供 XML 访问 ? 
如 果 需 要 为 第 三 方 应 用 收发 数据 ， 那 么 提供 Xml 访问 是 很 有 必要 的 。 


解法 


根据 要 访问 的 Xml 文件 (如 response.xml) 创 建 一 个 XML 模板 。 如 果 XML 中 有 变量 ， 就 
使 用 相应 的 模板 标签 进行 替换 。 下 面 是 一 个 例子 : 


$def with (code) 

<?xml version="1.0"?> 
<RequestNotification-Response> 
<Status>$code</Status> 
</RequestNotification-Response> 


为 了 提供 这 个 XML ， 需 要 创建 一 个 单独 的 web.py 程 序 (如 response.py)， 它 要 包 侈 下 
面 的 代码 。 注 意 : 要 用 "web.header('Content-Type', 'text/xml')" & 4& 4e Z P 38$ — — 3E 
在 发 送 的 是 一 个 XML 文件 。 


import web 
render = web.template.render('templates/', cache-False) 
urls = ( 

/A qe 
) 
app - web.application(urls, globals()) 
class index: 

def GET(self, code): 

web.header('Content-Type', 'text/xml') 


return render.response(code) 


web.webapi.internalerror - web.debugerror 
if | name == ' main ': app.run() 


从 post 读 取 原 始 数据 


介绍 
有 了 时候， 浏览 器 会 通过 post 发 送 很 多 数据 。 在 Webpy， 你 可 以 这 样 操作 。 
代码 


class RequestHandler(): 
def POST(): 
data = web.data() # 通过 这 个 方法 可 以 取 到 数据 


高 级 应 用 


web.ctx 


问题 


ans 


如 何在 代码 中 得 到 客户 端 信息 ? 比如 : 来 源 页 面 (referring page) 或 是 客户 端 浏览 
类 型 


解法 


使 用 web.ctx 即 可 。 首 先 讲 一 点 架构 的 东西 : Web.ctx 基 于 threadeddict 类 ， 又 被 叫做 
ThreadDict。 这 个 类 创建 了 一 个 类 似 字典 (dictionary-like) 的 对 象 ， 对 象 中 的 值 都 是 

与 线程 id 相对 应 的 。 这 样 做 很 妙 ,因为 很 多 用 户 同 时 访问 系 统 时 ， 这 个 字典 对 象 能 做 
到 仅 为 某 一 特定 的 HTTP 请 求 提供 数据 (因为 没有 数据 共 享 ， 所 以 对 象 是 线程 安全 的 ) 


web.ctx 保 存 每 个 HTTP 请 求 的 特定 信息 ， 比 如 客户 端 环 境 变量 。 人 假设， 我 们 想 知 道 
正在 访问 某 页 面 的 用 户 是 从 哪个 网 页 跳 转 而 来 的 : 


Gea 


class example: 
def GET(self): 
referer = web.ctx.env.get('HTTP REFERER', 'http://google.c« 
raise web.seeother (referer) 
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在 ， 就 会 将 google.com 做 为 默认 值 。 接 下 来 ， 用 户 就 会 被 重 定向 回 到 之 前 的 来 源 页 


Web.ctx 另 一 个 特性 ， 是 它 可 以 被 loadhook 赋 值 。 例 如 : 当 一 个 请 求 被 处 理 时 ， 会 


话 (Session) 就 会 被 设置 并 保存 在 web.ctx 中 。 由 于 web.ctx 是 线程 安全 的 ， 所 以 我 们 
可 以 象 使 用 普通 的 python 对 象 一 样 ， 来 操作 会 话 (Session)。 


'ctx' 中 的 数据 成 员 


Request 


e environ 又 被 写 做 .env 一 包含 标准 WSGI 环 境 变 量 的 字典 
e home 一 应 用 的 http 根 路 径 (译注 : 可 以 理解 为 应 用 的 起 始 网 址 ， NS 十 站 点 域 
名 十 应 用 所 在 路 径 ) 例 : http://example.org/admin 


homedomain 一 应 用 所 在 站 点 (可 以 理解 为 协议 十 域名 ) htip://example.org 
homepath 一 当前 应 用 所 在 的 路 径 ， 例 如 : /admin 

host 一 主机 名 (SUL) 十 用 户 请 求 的 端口 (如果 没有 的 话 ， 就 是 默认 的 80 
端口 ) ， 例 如 : example.org, example.org:8080 

ip 一 用 户 的 |P 地 址 ， 例 如 : XXX.XXX.XXX.XXX 

method 一 所 用 的 HTTP 方 法 ， 例 如 : GET 

path 一 用 户 请 求 路 径 ， 它 是 基于 当前 应 用 的 相对 路 径 。 在 子 应 用 中 ， 匹 配 外 


e 
部 应 用 的 那 部 分 网 址 将 被 去 掉 。 例 如 : 主 应 用 在 code.py 中 ， 而 子 应 用 


在 admin.py 中 。 在 code.py 中 , 我 们 将 /admin 关联 到 admin.app 。 

在 admin.py 中 ,将 /stories 关联 到 stories 类 。 在 stories 中 ， 
web.ctx.path 就 是 /stories ,而 非 /admin/stories 。 形 如 : 
/articles/845 

protocol 一 所 用 协议 ， 例 如 : https 

query — $&JE'? ' 字 符 后 面 的 查询 字符 串 。 如 果 不 存在 查询 参数 ， 它 就 是 一 个 
空 字 符 串 。 例 如 : ?fourlegs-good&twolegs-bad 

fullpath 可 以 视 为 path + query 一 包含 查询 参数 的 请 求 路 径 ， 但 不 包 
括 'homepath'。 例 如 : /articles/845?fourlegs-good&twolegs-bad 


Response 


status 一 HTTP 状 态 码 (默认 是 '200 OK) 401 Unauthorized 未 经 授权 
headers 一 包含 HTTP 头 信息 (headers) 的 二 元 组 列表 。 
output 一 包含 响应 实体 的 字符 囊 。 


Application processors 


Je] x 

ho f] f FE] Ez. FE] Ab SES > Ho #44 T (loadhooks)/fe $p R 44 F(unloadhook) ? 

解法 

Web.py 可 以 在 处 理 请 求 之 前 或 之 后 ， 通 过 添加 处 理 器 (processor) 来 完成 某 些 操作 。 


def my processor(handler): 
print 'before handling' 
result - handler() 
print 'after handling' 
return result 

app.add processor(my processor) 


T A A 29 3:45 F-(loadhook)4e $p 344 -T- (unloadhook)45 Zr AK ZA ILE 69 4&4E » € 
们 分 别 在 请 求 开 始 之 前 和 结束 之 后 工作 。 


def my_loadhook(): 
print "my load hook" 


def my unloadhook(): 
print "my unload hook" 


app.add processor(web.loadhook(my loadhook)) 
app.add processor(web.unloadhook(my unloadhook)) 


你 可 以 在 钧 子 中 使 用 和 修改 全 局 变量 ， 比 如 : web.header() 


def my loadhook(): 
web.header('Content-type', "text/html; charset-utf-8") 


app.add processor(web.loadhook(my loadhook)) 


提示 : 你 也 可 以 在 钩子 中 使 用 web.ctx 和 web.input() 。 


def my_loadhook(): 
input = web.input() 
print input 


如 何 使 用 web.background 


注意 1 | web. backgrounder 已 转移 到 web.py 3.X 实 验 版 本 中 ， ee 
一 部 分 。 你 可 以 在 这 里 下 载 ， 要 把 它 与 application.py 放 置 在 同一 目录 下 才能 


4L 
o 


e 


介绍 


web.background#?web. backgrounder < python & 装饰 器 ， 它 可 以 让 某 个 函 式 在 一 

个 单独 的 background 线 程 中 运行 ， 而 主线 程 继续 处 理 当 前 的 HTTP 请 求 ， 并 在 稍 后 
报告 background 线 程 的 状态 (事实 上 ， 后 台 函 式 的 标准 输出 (stdout) 被 返回 给 尼 动 该 
线程 的 "backrounder")。 译注 : 我 本 来 想 thread 翻 译 为 后 台 线 程 ， 后 
来 认为 作者 本 意 是 想 表 达 “ 被 background 修 饰 的 函 式 所 在 的 线程 ”， 最 后 翻译 采 

用 “background 线 程 ” 


这 样 ， 服 务 器 就 可 以 在 处 理 其 他 http 请 求 的 同时 ， 快 LAR he ERE 端 请 
求 。 同 时 ，background 线 程 继续 执行 需要 长 时 间 运 行 的 函 式 。 


人 


#!/usr/bin/env python 
utf-8 


# -*- coding: 


from web import run, 
from datetime import datetime; 


* 


background, backgrounder 


from time import sleep 


urls = ( 


'/', 'index', 


class index: 


@backgrounder 


def GET(self): 


print "Started at %s" % now() 


now 


print "hit f5 to refresh!" 
longrunning() 


Qbackground 


def longrunning(): 
for i in range(10): 
sleep(1) 

print "%s: %s" % (i, 


if __name__ 
run(urls, 


| main . 


globals()) 


now( ) ) 


datetime.now 


在 请 求 http://localhost:8080/ 时 ， 将 自动 重 定向 到 类 似 http://localhost:8080/? 
_t=3080772748 的 网 en d &4 3 F 357€ background A id) > 


新 之 后 ) 就 会 


Started at 2008-06-14 15:50:26.764474 


Jee f5 to refresh! 


2008-06-14 
2008-06-14 
2008-06-14 
2008-06-14 
2008-06-14 
2008-06-14 
2008-06-14 
2008-06-14 
2008-06-14 
2008-06-14 


Koa GA N en ae ee 


提示 


. 
AS 


15: 
15: 
15: 
ity 
15: 
15; 
15: 
alloys 
15: 
iiis 


50: 
50: 
50: 
50: 
50: 
50: 
50: 
50: 
50: 
50: 


看 到 如 下 信息 ps 
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. 763813 
28. 
20: 
30. 
31. 
32. 
33. 
34. 
35. 
36. 


763861 
763844 
763853 
764778 
763852 
764338 
763925 
763854 
763789 


web.py 在 background.threaddb 字 典 中 保存 线程 信息 。 


这 就 


1 


KÄ 


接 下 来 (在 点 


~ 


容 


多 


检查 


击 几 次 刷 


线程 的 状 


class threaddbviewer: 
def GET(self): 
for k, v in background.threaddb.items(): 
print "%s - 96s" 96 ( k v) 


Web.py 并 不 会 主动 去 清空 threaddb 词 典 ， 这 使 得 输出 (如 http://localhost:8080/? 
_t=3080772748) 会 一 直 执 行 ， 直 到 内 存 被 用 满 。 

通常 是 在 backgrounder 骂 式 中 做 线程 清理 工作 ， 是 因为 backgrounder 可 以 获得 线程 
id( 通 过 web.input() 得 到 "tn 的 值 ， 就 是 线程 id)， 从 而 根据 线程 id 来 回收 资源 。 这 是 
为 虽然 background 能 知道 自己 何 时 结束 ， 但 它 无 法 获得 自己 的 线程 id， 所 以 
background 无 法 自己 完成 线程 清理 。 

还 要 注意 How not to do thread local storage with Python 在 python 中 如 何 避 免 多 线 
程 本 地 存储 - 线程 ID 有 时 会 被 重用 (可 能 会 引发 错误 ) 


在 使 用 web.background 时 ， 还 是 那 句 话 一 一 “小心 为 上 ” 


自 定 义 NotFound 消 息 


问题 


如 何 定义 NotFound 消 息 和 其 他 消息 ? 
解法 


import web 


urls = (x) 
app = web.application(urls, globals()) 


def notfound(): 
return web.notfound("Sorry, the page you were looking for was rı 


# You can use template result like below, either is ok: 

#return web.notfound(render.notfound()) 

return web.notfound(str(render.notfound())) 
app.notfound - notfound 


lU 


要 返回 自 定 义 的 NotFound 消 息 ， 这 么 做 即 可 : 





class example: 
def GET(self): 
raise web.notfound( ) 


也 可 以 用 同样 的 方法 自 定义 500 错 误 消息 : 


def internalerror(): 
return web.internalerror("Bad, bad server. No donut for you.") 


app.internalerror = internalerror 


二 向" 


如 何 流传 输 大 文件 


问题 

如 何 流传 输 大 文件 ? 

解法 

要 流传 输 大 文件 ， 需 要 添加 传输 译 码 (Transfer-Encoding) 区 块头 ， 这 样 才能 一 边 下 
载 一 边 显示 。 否 则 ， 浏 览 器 将 缓冲 所 有 数据 直到 下 载 完 毕 才 显示 。 

如 果 这 样 写 : 直接 修改 基础 字符 串 ( 例 中 就 是 )， 然 后 用 Yield 返 回 一 一 是 没有 效果 
的 。 如 果 要 使 用 Yield, 就 要 向 对 所 有 内 容 使 用 yield。 因 为 这 个 函 式 此 时 是 一 个 产生 
器 。( 注 : 请 处 请 详 看 Yield 文 档 ， 在 此 不 做 过 多 论述 。) 

例子 


# Simple streaming server demonstration 

# Uses time.sleep to emulate a large file read 
import web 

import time 


urls = ( 
D Y "count holder", 
"/(.*)", "count_down", 
) 
app - web.application(urls, globals()) 


class count down: 
def GET(self,count): 
4 These headers make it work in browsers 
web.header('Content-type', 'text/html') 
web.header('Transfer-Encoding', 'chunked' ) 
yield '<h2>Prepare for Launch!</h2>' 
j = '<li>Liftoff in %s...</li>' 
yield '<ul>' 
count = int(count) 
for i in range(count,0,-1): 
out = j% i 
time.sleep(1) 
yield out 
yield '</ul>' 
time.sleep(1) 
yield '<hi>Lift off</h1>' 


class count_holder: 
def GET(self): 
web.header('Content-type', 'text/html') 
web.header('Transfer-Encoding', 'chunked' ) 
boxes = 4 
delay = 3 
countdown = 10 
for i in range(boxes): 
output = '<iframe src="/%d" width="200" height="500"><, 
yield output 
time.sleep(delay ) 


if | name == "_ main_": 
app.run() 


SSS SS sev 





管理 自 带 Webserver 日 志 


Je] x 
如 何 操作 web.py 自 带 的 webserver 的 日 志 ? 
解法 


我 们 可 以 用 wsgilog 来 操作 内 置 的 webserver 的 日 志 ， 并 做 其 为 中 间 件 加 到 应 用 中 。 


如 下 ， 写 一 个 Log 类 继承 wsgilog.WsgiLog， 在 init 中 把 参数 传 给 基 类 ， 如 这 个 例 
Js 


import sys, logging 
from wsgilog import WsgiLog, LogIO 
import config 


class Log(WsgiLog): 
def | init (self, application): 
WsgiLog. (init ( 
self, 
application, 
logformat = '%(message)s', 
tofile = True, 
file = config.log file, 
interval = config.log_interval, 
backups = config.log_backups 
) 
sys.stdout 
sys.stderr 


LogIO(self.logger, logging.INFO) 
LogIO(self.logger, logging.ERROR) 


接 下 来 ， 当 应 用 运行 时 ， 传 递 一 个 引用 给 上 例 中 的 Log 类 即 可 (假设 上 面 代码 
是 'mylog' 模 块 的 一 部 分 ， 代 码 如 下 ): 


from mylog import Log 
application = web.application(urls, globals()) 
application. run(Log) 


用 cherrypy 提 供 SSL 支 持 


问题 


如 何 用 内 置 的 cheerypy 提 供 SSL 支 持 ? 
解法 


import web 
from web.wsgiserver import CherryPyWSGIServer 


CherryPyWSGIServer.ssl certificate 
CherryPyWSGIServer.ssl private key 


"path/to/ssl certificate" 
"path/to/ssl private key" 


urls = ("/.*", "hello") 
app - web.application(urls, globals()) 


class hello: 
def GET(self): 
return 'Hello, world!' 


if name --"" main_": 
app.run() 


实时 语言 切换 


Je] zt : 


如 何 实 现实 时 语言 切换 ? 


解法 : 
e 首先 你 必须 阅读 模板 语言 中 的 i18n 支 持 , 然后 尝试 下 面 的 代码 。 
文件 : code.py 


import os 
import sys 
import gettext 
import web 


# File location directory. 
rootdir = os.path.abspath(os.path.dirname( (file )) 


# i18n directory. 
localedir = rootdir + '/ii18n' 


# Object used to store all translations. 
allTranslations - web.storage() 


def get translations(lang-'en US'): 
4 Init translation. 
if allTranslations.has key(lang): 
translation - allTranslations[lang] 
elif lang is None: 
translation = gettext.NullTranslations() 
else: 
try: 
translation - gettext.translation( 
'messages', 
localedir, 
languages=[lang], 


except IOError: 
translation = gettext.NullTranslations() 
return translation 


def load translations(lang): 
"""Return the translations for the locale.""" 
lang = str(lang) 
translation = allTranslations.get(lang) 


if translation is None: 
translation = get_translations(lang) 
allTranslations[lang] = translation 


# Delete unused translations. 
for lk in allTranslations.keys(): 
if lk !- lang: 
del allTranslations[lk] 
return translation 


def custom gettext(string): 
"""Translate a given string to the language of the application 
translation = load translations(session.get('lang!')) 
if translation is None: 
return unicode(string) 
return translation.ugettext(string) 


urls = ( 
‘7’, index: 


) 


render = web.template.render('templates/', 
globals={ 
'_': custom gettext, 
} 
) 


app = web.application(urls, globals()) 


# Init session. 
session = web.session.Session(app, 
web.session.DiskStore('sessions'), 
initializer={ 
'lang': 'en US', 
} 
) 


class index: 
def GET(self): 
i = web.input() 
lang = i.get('lang', 'en US') 


# Debug. 
print »» sys.stderr, 'Language:', lang 


session['lang'] = lang 
return render.index() 


if | name == " main ": app.run() 


«| E 











模板 文件 : templates/index.html. 


$ ('Hello') 


不 要 忘记 生成 必要 的 po&mo 语 言 文件 。 参 考 ; 模板 语言 中 的 i18n 支 持 


现在 运行 code.py: 


$ python code .py 
http://0.0.0.0:8080/ 


然后 用 你 喜欢 的 浏览 器 访问 下 面 的 地 址 ， 检 查 语言 是 否 改变 : 


http://your server:8080/ 
http://your server:8080/?1lang-en US 
http://your server:8080/?1lang-zh CN 


你 必须 : 


e 确保 语言 文件 (en_US、zh_CN 等 ) 可 以 动态 改变 。 
e 确保 custom_gettext() 调 用 越 省 资源 约 好 。 


参考 : 
e 这 里 有 使 用 app.app_processor() 的 另 一 个 方案 。 


Sessions and user state 会 话 和 用 户 状 态 


Sessions 


问题 


如 何在 web.py 中 使 用 session 


解法 
注意 1 ! ! : Session 并 不 能 在 调试 模式 (Debug mode) 下 正常 工作 ， 这 是 因为 


SeSSion 与 调试 模 试 下 的 重 调用 相 冲 突 ( 有 点 类 似 firefox 下 著名 的 Firebug 插 件 ， 使 用 
Firebug 插 件 分 析 网 页 时 ， 会 在 火狐 浏览 器 之 外 单独 对 该 网 页 发 起 请 求 ， 所 以 相当 于 
同时 访问 该 网 页 两 次 )， 下 一 节 中 我 们 会 给 出 在 调试 模式 下 使 用 session 的 解决 办 

法 。 


web.session 模块 提供 session 支 持 。 下 面 是 一 个 简单 的 例子 一 一 统计 有 多 少 人 正 
在 使 用 session(session 计 数 器 ) : 


import web 
web.config.debug = False 
urls = ( 
"/count", "count", 
"/reset", "reset" 
) 
app = web.application(urls, locals()) 
session = web.session.Session(app, web.session.DiskStore('sessions 


class count: 
def GET(self): 
session.count += 1 
return str(session.count ) 


class reset: 
def GET(self): 
session.kill() 
return "" 


if name == "_ main_": 
app.run() 


4 = $ 





Web.py 在 处 理 请 求 之 前 ， 就 加 载 session 对 象 及 其 数据 ; 在 请 求 处 理 完 之 后 ， 会 检 
查 session 数 据 是 否 被 改动 。 如 果 被 改动 ， 就 交 由 session 对象 保 存 。 


上 例 中 的 initializer 参数 决定 了 session 初 始 化 的 值 ， 它 是 个 可 选 参 数 。 


如 果 用 数据 库 代 替 磁 瘟 文 件 来 存储 session 信息 ， 只 要 用 DBStore 代 
4 DiskStore 即 可 。 使 用 DBStore 需 要 建立 一 个 表 ， 结 构 如 下 : 


create table sessions ( 

session_id char(128) UNIQUE NOT NULL, 

atime timestamp NOT NULL default current_timestamp, 
data text 


): 


DBStore 被 创建 要 传 入 两 个 参数 : db 对 象 和 session 的 表 名 。 


db = web.database(dbn='postgres', db='mydatabase', user='myname', [ 
store = web.session.DBStore(db, 'sessions') 
session = 


PD ëa 


web.session.Session(app, store, initializer={'count': 0} 





‘web.config “中 的 sessions parameters 保存 着 Session 的 相关 设 
置 ， sessions parameters 本 身 是 一 个 字典 ， 可 以 对 其 修改 。 默 认 设置 如 下 : 


web. 
web. 
web. 
web. 
web. 
web. 
web. 


Oe 


cookie name - 保存 session id 的 Cookie 的 名 称 

cookie_domain - 保存 session id 的 Cookie 的 domain 信 息 

timeout - session 的 有 效 时 间 ， 以 秒 为 单位 

ignore expiry - 如 果 为 True，session 就 水 不 过 期 

ignore change ip - 如 果 为 False， 就 表明 只 有 在 访问 该 session 的 IP 与 创建 该 


config. 
config. 
config. 
config. 
.session parameters['ignore change ip'] = True 


config 


config. 
config. 


session parameters['cookie name'] = 'webpy session id' 
session parameters['cookie domain'] - None 

session parameters['timeout'] = 86400, #24 * 60 * 60, # 
session parameters['ignore expiry'] - True 


session parameters['secret key'] = 'fLjUfxqXtfNo1IldAO0AO0. 
session parameters['expired message'] = 'Session expire 





session 4 IP ZZ 4 — & HH > session 4 3& /, F3 I] © 
e secret key - 密码 种 子 ， 为 session 加 密 提 供 一 个 字符 串 种 子 
e expired_message - session 过 期 时 显示 的 提示 信息 。 


在 调试 模式 下 使 用 Session 


问题 


如 何在 调试 模式 下 使 用 Session? 
解法 


使 用 web.py 自 带 的 webserver 提 供 web 服 务 时 ，web.py 就 运行 在 调试 模式 下 。 当 然 


最 简单 的 办 法 就 是 禁用 调试 ， 只 要 令 web.config.debug = False 即 可 。 


import web 
web.config.debug = False 


# rest of your code 


如 果 非 要 用 调试 模式 下 使 用 session， 可 以 用 非 主流 的 一 些 办 法 。 哈 哈 


因为 调试 模式 支持 模块 重 载 入 ( 重 载 入 ， 绝 非 重 载 。 是 reload, 而 非 override)， 所 以 
reloader 会 载 入 主 模块 两 次 ， 因 此 ， 就 会 创建 两 个 session 对 象 。 但 我 们 只 要 把 
Session 存储 在 全 局 的 数据 容器 中 ， 就 能 避免 二 次 创建 session 。 


下 面 这 个 例子 就 是 把 session 保 存在 web.config 中 : 


import web 
urls = ("/", "hello") 


app = web.application(urls, globals() ) 


if web.config.get('_session') is None: 
session = web.session.Session(app, web.session.DiskStore('sess: 
web.config._session = session 

else: 
session = web.config. session 


class hello: 
def GET(self): 
print 'session', session 
session.count += 1 
return 'Hello, %s!' 96 session.count 


if | name == "main ": 
app.run() 
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在 调试 模式 下 使 用 session 


50 


在 template 中 使 用 session 
问题 : 我 想 在 模板 中 使 用 session (比如 : 读 取 并 显示 session.username ) 
解决 : 
在 应 用 程序 中 的 代码 : 
render = web.template.render('templates', globals={'context': sess: 
E ys 人 ss 一 一 和 
在 模板 中 的 代码 : 





<Span>You are logged in as <b>$context.username</b></span> 


ART VAL SE 09 18 AETA S18 A python € EA > rete Et A 89 context » REEK 
在 应 用 中 直接 使 用 'session'。 


如 何 操作 Cookie 

问题 

如 何 设置 和 获取 用 户 的 Cookie? 

解法 

对 Web.py 而 言 ， 设 置 / 获 取 Cookie 非 常 方便 。 
iX à Cookies 

概述 


setcookie(name, value, expires="", domain=None, secure=False): 


e name (string) - Cookie 的 名 称 ， 由 浏览 器 保存 并 发 送 至 服务 器 。 

e value (string) -Cookie 的 值 ， 与 Cookie 的 名 称 相对 应 。 

e expires (int) - Cookie 的 过 期 时 间 ， 这 是 个 可 选 参数 ， 它 决定 Cookie 有 效 时 
间 是 多 久 。 以 秒 为 单位 。 它 必须 是 一 个 整数 ， 而 绝 不 能 是 字符 串 。 

e domain (string) - Cookie 的 有 效 域 一 在 该 域内 cookie 才 是 有 效 的 。 一 般 情 
况 下 ， 要 在 某 站 点 内 可 用 ， 该 参数 值 该 写 做 站 点 的 域 (比如 .Webpy.org) ， 而 
不 是 站 主 的 主机 名 ( a org) 

e secure (bool) - 如 果 为 True， 要 求 该 Cookie 只 能 通过 HTTPS 传 输 。. 


示例 
用 web.setcookie() 设置 cookie, 如 下 : 


class CookieSet: 
def GET(self): 
i = web. input(age='25') 
web.setcookie('age', i.age, 3600) 
return "Age set in your cookie" 


用 GET 方 式 调 用 上 面 的 类 将 设置 一 个 名 为 age, 默 认 值 是 25 的 cookie( 实 际 上 ， 默 认 
值 25 是 在 web.input 中 赋 子 ij.age 的 ， 从 而 间接 赋予 cookie > m 7 ÆA setcookie 5 X 
中 直接 赋予 cookie 的 )。 这 个 cookie 将 在 一 小 时 后 ( 即 3600 秒 ) 过 期 。 


大 大 一 


web.setcookie() 的 第 三 个 参数 一 "expires" 是 一 个 可 选 参 数 ， 它 用 来 设 定 cookie 
过 期 的 时 间 。 如 果 是 负数 ，cookie 将 立刻 过 期 。 如 果 是 正 数 ， 就 表示 cookie 的 有 效 
时 间 是 多 久 ， 以 秒 为 单位 。 如 果 该 参数 为 空 ，cookie 就 永 不 过 期 。 


获得 Cookies 
概述 


获取 Cookie 的 值 有 很 多 方法 ， 它 们 的 区 别 就 在 于 找 不 到 cookie 时 如 何 处理 。 


方法 1 (如 果 找 不 到 cookie， 就 返回 None ) 


web.cookies().get(cookieName) 
ZcookieName is the name of the cookie submitted by the browser 


IE 上 :| 
方法 2 (如 果 找 不 到 cookie， 就 抛 出 AttributeError 了 异常 ) 


foo = web.cookies() 
foo.cookieName 


方法 3 (如 果 找 不 到 cookie， 可 以 设置 默认 值 来 避免 抛 出 异常 ) 


foo = web.cookies(cookieName-defaultValue) 
foo.cookieName # return the value (which could be default) 
ZcookieName is the name of the cookie submitted by the browser 


B]p————————Á—————————— EU] 
示例 : 

用 web.cookies() 访问 cookie. 如 果 已 经 用 web.setcookie() 设置 了 Cookie， 
就 可 以 象 下 面 这 样 获 得 Cookie: 


class CookieGet: 
def GET(self): 
c = web.cookies(age="25" ) 
return "Your age is: " + c.age 


这 个 例子 为 cookie 设 置 了 默认 值 。 这 么 做 的 原因 是 在 访问 时 ， 若 cookie 不 存在 ， 
web.cookies() 就 会 抛 出 异常 ， 如 果 事 先 设置 了 默认 值 就 不 会 出 现 这 种 情况 。 


如 果 要 确认 cookie 值 是 否 存在 ， 可 以 这 样 做 : 


class CookieGet: 
def GET(self): 
try: 
return "Your age is: " + web.cookies().age 
except: 
# Do whatever handling you need to, etc. here. 
return "Cookie does not exist." 


x 


class CookieGet: 
def GET(self): 
age=web.cookies().get('age') 
if age: 
return "Your age is: %S" % age 
else: 
return "Cookie does not exist." 


用 户 认证 


Wa 


原作 者 没有 写 完 ， 但 是 可 以 参照 下 一 节 ， 写 得 很 详细 


问题 


如 何 完成 一 个 用 户 认证 系统 ? 


解法 


用 户 认 证 系统 由 这 几 个 部 分 组 成 : 用 户 添 加 ， 用 户 登 录 ， 用 户 注 销 以 及 验证 用 户 是 
否 已 登录 。 用 户 认 证 系统 一 般 都 需要 一 个 数据 库 。 在 这 个 例子 中 ， 我 们 要 用 到 MD5 
和 SQLite。 


i 


import hashlib 
import web 


def POST(self): 
i - web.input() 


authdb - sqlite3.connect('users.db') 
pwdhash - hashlib.md5(i.password).hexdigest() 
check = authdb.execute('select * from users where username-? ar 
if check: 
session.loggedin - True 
session.username - i.username 
raise web.seeother('/results') 
else: return render.base("Those login details don't work.") 


E 





aly 


GE, 


HG bo ARI UR AERA EP REP ER 。 


在 PostgreSQL 下 实现 用 户 认证 
问题 
e 如 何 利 用 PostgreSQL 数 据 库 实现 一 个 用 户 认 证 系统 ? 
解法 
e 用 户 认 证 系统 有 很 多 功能 。 在 这 个 例子 中 ， 将 展示 如 何在 PostgreSQL 数 据 库 
环境 下 一 步 一 步 完 成 一 个 用 户 认证 系统 


e 因为 要 用 到 make 模 板 和 postgreSQL 数 据 库 ， 所 以 要 : import web from 
web.contrib.template import render_ mako import pg 


第 一 步 : 创建 数据 库 


首先 ， 为 创建 一 个 用 户 表 。 虽 然 这 个 表 结 构 非常 简单 ， 但 对 于 大 部 分 项 目 来 说 都 足 
够 用 了 。 


CREATE TABLE example_users 


( 
id serial NOT NULL, 
user character varying(80) NOT NULL, 
pass character varying(80) NOT NULL, 
email character varying(100) NOT NULL, 
privilege integer NOT NULL DEFAULT 0, 
CONSTRAINT utilisateur_pkey PRIMARY KEY (id) 


—3 : 确定 网 址 
登录 和 注销 对 应 两 个 网 址 : 
e "Login" 对 应 登录 页 


e "Reset" 对 应 注销 页 


urls = ( 
'/login', 'login', 
'/reset', 'reset', 


) 


第 三 步 : 判断 用 户 是 否 登 录 


要 判断 用 户 是 否 已 登录 ， 是 非常 简单 的 ， 只 要 有 个 变量 记录 用 户 登 录 的 状态 即 可 。 
在 login/reset 类 中 使 用 这 段 代 码 : 


def logged(): 
if session. login==1: 
return True 
else: 
return False 


第 四 步 : 简单 的 权限 管理 


我 把 我 的 用 户 划 为 四 类 : 管理 员 ， 用 户 ， 读 者 (CER) ， 访 客 (KER) 。 根 据 
example_users 表 中 定义 的 不 同 权限 ， 选 择 不 同 的 模板 路 径 。 


def create_render(privilege): 
if logged(): 
if privilege==0: 
render = render_mako( 
directories=['templates/reader'], 
input encoding-'utf-8', 
output encoding-'utf-8', 
) 
elif privilege--1: 
render - render mako( 
directories-['templates/user'], 
input encoding-'utf-8', 
output encoding-'utf-8', 


elif privilege--2: 
render - render mako( 
directories-['templates/admin'], 
input encoding-'utf-8', 
output encoding-'utf-8', 


) 
else: 
render - render mako( 
directories-['templates/communs'], 
input encoding-'utf-8', 
output encoding-'utf-8', 
) 


return render 


第 五 : & R(Login)# 4i (Reset) python X 


现在 ， 让 我 们 用 个 轻松 的 方法 来 解决 : - 如 果 你 已 登录 ， 就 直接 重 定向 到 
login_double.html 模 板 文件 - 否则 ， 还 是 到 login.html 。 


class login: 
def GET(self): 
if logged(): 
render = create_render(session. privilege) 
return "%s" % ( 
render .login_double() ) 
else: 
render = create_render(session.privilege) 
return "%s" % ( 
render .login() 


) 


e 好 了 。 现 在 写 POST() 方 法 。 从 .html 文 件 中 ， 我 们 得 到 表单 提交 的 变量 值 ( 见 
login.html)， 并 根据 变量 值得 到 example_users 表 中 对 应 的 user 数 据 
e 如 果 登 录 通 过 了 ， 就 重 定向 到 login_ok.html。 


e 如 果 没 通过 ， 就 重 定 向 到 login_error.html。 


def POST(self): 


user, passwd = web.input().user, web.input().passwd 
ident = db.query("select * from example users where user = 
try: 
if passwd==ident[0][2]: 
session.login-1 
session.privilege-ident[0][4] 
render - create render(session.privilege) 
return "%s" 96 ( 
render.login ok() 


) 
else: 
session. login=0 
session. privilege=0 
render = create_render(session.privilege) 
return "%s" % ( 
render.login error() 


) 
except: 
session. login=0 
session. privilege=0 
render = create_render(session.privilege) 
return "%s" % ( 
render.login error() 


) 
b 履 





对 于 reset 方 法 ， 只 要 清除 用 户 session， 再 重 定向 到 logout.html 模 板 页 即 可 。 


class reset: 
def GET(self): 
session. login=0 
session.kill() 
render = create_render(session.privilege) 
return "%s" % ( 
render . logout ( ) 


) 


6th: 第 六 步 : HTML 模 板 帮助 


咽 ， 我 认为 没有 人 想 看 这 个 ， 但 我 喜欢 把 所 有 的 信息 都 提供 出 来 。 最 重要 的 就 是 
login.html » 


<FORM action=/login method=POST> 
<table id="login"> 
<tr> 
<td>User: </td> 
<td><input type=text name='user'></td> 
</tr> 
<tr> 
<td>Password: </td> 
<td><input type="password" name=passwd></td> 
</tr> 
<tr> 
<td></td> 
<td><input type=submit value=LOGIN></td> 
</tr> 
</table> 
</form> 


第 七 : 问题 或 疑问 ? 


e 邮件 : 您 可 以 联想 我 ， 我 的 邮箱 是 guillaume(at)process-evolution(dot)fr 

e IRC : #webpy on irc.freenode.net (pseudo: Ephedrax) 

e 翻译 : 我 是 法 国人 ， 我 的 英文 不 好 .… 你 可 以 修改 我 的 文档 (译注 : 哈哈 ， 谦 虚 
啥 ， 你 那 是 没 见 过 wrongway 的 山东 英文 …) 


在 子 应 用 下 使 用 session 


个 解决 方案 是 来 自 web.py 邮 件 列 表 。this 


(a 


问题 
如 何在 子 应 用 中 使 用 session? 
解法 


web.py 默 认 session 信 息 只 能 在 主 应 用 中 共享 ， 即 便 在 其 他 模块 中 import Session 都 
不 行 。 在 app.py (或 main.py) 可 以 这 样 初始 化 session : 


session = web.session.Session(app, web.session.DiskStore('sessions 
initializer = {'test': 'woot', 'foo':''}) 


了 





.. 接 下 来 创建 一 个 被 web.loadhook 加 载 的 处 理 器 (processon) 


def session_hook(): 
web.ctx.session = session 


app.add_processor (web. loadhook(session_hook) ) 


.. 在 子 应 用 (假设 是 sub-app.py) 中 ， 可 以 这 样 操作 session: 


print web.ctx.session.test 
web.ctx.session.foo = 'bar' 


Utils 实用 工具 


发 送 邮件 

问题 

在 web.py 中 ， 如 何 发 送 邮件 ? 

解法 

在 Web.py 中 使 用 web.sendmail() 发 送 邮件 . 


web.sendmail('cookbookQwebpy.org', 'userQexample.com', 'subject', 
EEE ———————— JÓ''-—zzift 


如 果 在 web.config 中 指定 了 邮件 服务 器 ， 就 会 使 用 该 服务 器 发 送 邮件 ， 否 则 ， 
就 根据 /usr/lib/sendmail 中 的 设置 发 送 邮 件 。 





web.config.smtp_server = 'mail.mydomain.com' 


如 果 要 发 送 邮 件 给 多 个 收 件 人 ， 就 给 to_address 赋 值 一 个 邮箱 列表 。 
web.sendmail('cookbookQwebpy.org', ['useri@example.com', 'user2Qex: 
一 


cc 和 bcc 关键 字 参 数 是 可 选 的 ， 分 别 表示 抄 送 和 暗 送 接收 人 。 这 两 个 参数 也 可 
以 是 列表 ， 表 示 抄 送 / 瞳 送 多 人 。 





web.sendmail('cookbookQwebpy.org', 'userQexample.com', 'subject', 
有 HE 


headers 参数 是 一 个 元 组 ， 表 示 附 加 标 头 信息 (Addition headers) 





web.sendmail('cookbookQwebpy.org', 'userQexample.com', 'subject', 
cc-'useriQexample.com', bcc='user2@example.com', 
headers=({'User-Agent': 'webpy.sendmail', 'X-Mailer': 'web[ 
) 


pe ——————Ó MÀ Pu 





如 何 用 Gmail 发 送 邮件 
问题 

如 何 用 Gmail 发 送 邮 件 ? 

解法 


安装 和 维护 邮件 服务 器 通常 是 沉 问 乏 味 的 。 所 以 如 果 你 有 Gmail 帐 号 ， 就 可 以 使 用 
Gmail 做 为 SMTP 服 务 器 来 发 送 邮 件 ， 我 们 唯一 要 做 的 就 只 是 在 web.config 中 指 
定 Gmail 的 用 户 名 和 密码 。 


web.config.smtp_server = 'smtp.gmail.com' 
web.config.smtp_port = 587 

web.config.smtp_username 
web.config.smtp_password 
web.config.smtp_starttls 


' cookbookQgmail.com' 
'secret' 
True 


设置 好 之 后 ，web.sendmail 就 能 使 用 Gmail 帐号 来 发 送 邮 件 了 ， 用 起 来 和 其 他 邮件 
服务 器 没有 区 别 。 


web.sendmail( 'cookbook@gmail.com', 'userQexample.com', 'subject', 





可 以 在 这 里 了 解 有 关 Gmail 设 置 的 更 多 信息 GMail: Configuring other mail clients 


用 soaplib 实 现 webservice 


问题 
如 何 用 soaplib 实 现 webservice? 
解法 


Optio 的 soaplib 通 过 用 装饰 器 指定 类 型 ， 从 而 直接 编写 SOAP web service ° m EÈ 
也 是 到 目前 为 止 ， 唯 一 为 web service 提 供 WSDL 文 档 的 Python 类 库 。 


import web 

from soaplib.wsgi soap import SimplewSGISoapApp 

from soaplib.service import soapmethod 

from soaplib.serializers import primitive as soap types 


urls = ("/hello", "HelloService", 
"/hello.wsdl", "HelloService", 


render = web.template.Template("$def with (var)\n$:var") 


class SoapService(SimpleWSGISoapApp): 
"""Class for webservice """ 


#_tns_ = 'http://test.com' 


Qsoapmethod(soap types.String, returns-soap types.String) 
def hello(self,message): 

""" Method for webservice""" 

return "Hello world "+message 


class HelloService(SoapService): 
JUD ST LEAS for web.py nni 
def start response(self,status, headers): 
web.ctx.status - status 
for header, value in headers: 
web.header(header, value) 


def GET(self): 
response = super(SimplewSGISoapApp, self). call (web.ctx 
return render("\n".join(response) ) 


def POST(self): 
response = super(SimplewSGISoapApp, self). call (web.ctx 
return render("\n".join(response) ) 


app=web.application(urls, globals()) 


if name == "_ main_": 
app.run() 


IOO O 





可 以 用 soaplib 客 户 端 测试 一 下 : 


>>> from soaplib.client import make_service_client 

>>> from test import HelloService 

>>> client = make service client('http://localhost:8080/hello', He: 
>>> client.hello('John') 

"Hello world John' 


‘ 一 一 一 





+] 





Web.py Cookbook 中 文 版 


可 以 在 http://localhost:8080/hello.wsdl 查 看 WSDL 。 
欲 了 解 更 多 ， 请 查看 soaplib， 


用 soaplib 实 现 webservice 
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Templates 模板 


Templetor: web.py 模板 系统 


Introduction 


web.py 的 模板 语言 叫做 Templetor ， 它 能 负责 将 python 的 强大 功能 传递 给 模板 
系统 。 在 模板 中 没有 重新 设计 语法 ， 它 是 类 python 的 。 如果 你 会 python， 你 可 以 
顺手 牛 来 。 


这 是 一 个 模板 示例 : 


$def with (name) 
Hello $name! 


第 一 行 表示 模板 定义 了 一 个 变量 name 。 第 二 行 中 的 $name 将 会 用 name 的 
值 来 替换 。 


如 果 是 从 Web.py 0.2 升级 请 看 这 里 升 


ss 
E 
3 


使 用 模板 系统 
通用 泻 染 模板 的 方法 : 


render = web.template.render('templates' ) 
return render.hello('world') 


render 方法 从 模板 根 目 录 查 找 模板 文件 ， render.hello(..) ATÈ% 
hello.html 模板 。 实 际 上 ， 系 统 会 在 根 目录 去 查找 叫 hello 的 所 有 文件 ， 直 到 找 
到 匹配 的 。( 事 实 上 他 只 支持 .html 和 .xml 两 种 ) 


除了 上 面 的 使 用 方式 ， 你 也 可 以 直接 用 文件 的 方式 来 处 理 模 板 frender 


hello = web.template.frender('templates/hello.html') 
render hello('world') 


直接 使 用 字符 串 方式 : 


template = "$def with (name)\nHello $name" 
hello = web.template.Template(template) 
return hello('world') 


语法 


RIAA A 


特殊 字符 $ 被 用 于 特殊 的 python 表达 式 。 表 达 式 能 够 被 用 于 一 些 确 定 的 组 合 当 
中 ESB 和 Rag: 


Look, a $string. 
Hark, an ${arbitrary + expression}. 
Gawk, a $dictionary[key].function('argument'). 
Cool, a $(limit)ing. 
赋值 
有 时 你 可 能 需要 定义 一 个 新 变量 或 给 一 些 变量 重新 赋值 ， 如 下 
$ bug = get_bug(id) 
<hi>$bug.title</hi> 
<div> 


$bug.description 
<div> 


注意 $ 在 赋值 变量 名 称 之 前 要 有 一 个 空格 ， 这 有 区 别 于 常规 的 赋值 用 法 。 
模板 默认 会 使 用 web.websafe 过 滤 html 内 容 (encodeing 处 理 )。 


>>> render.hello("1 < 2") 
"Hello 1 &lt; 2" 


不 需要 过 滤 可 以 在 $ 之 后 使 用 : 。 示 例 : 


该 Html 内 容 不 会 被 义 
$:form.render() 


新 起 一 行 用 法 


在 行 末 添 加 \， 代 表 显 示 层 该 内 容 不 会 被 趴 实 处 理 成 一 行 。 


If you put a backslash \ 

at the end of a line \ 

(like these) \ 

then there will be no newline. 


L $ 
使 用 $$ 可 以 在 输出 的 时 候 显示 字符 $. 


Can you lend me $$50? 


注释 
$4 是 注释 指示 符 。 任 何以 gH 开始 的 某 行 内 容 都 被 当做 注释 。 


$# this is a comment 
Hello $name.title()! $# display the name in title case 


控制 结构 


模板 系统 支持 for, while , if , elif 和 else 。 像 python 一样， 这 里 是 
需要 缩 进 的 。 


$for i in range(10): 
I like $i 


$for i in range(10): I like $i 


$while a: 
hello $a.pop() 


$if times » max: 

Stop! In the name of love. 
$else: 

Keep on, you can do it. 


for 循环 内 的 成 员 变量 只 在 循环 内 发 生 可 用 : 


loop.index: the iteration of the loop (1-indexed) 
loop.index0: the iteration of the loop (0-indexed) 
loop.first: True if first iteration 

loop.last: True if last iteration 

loop.odd: True if an odd iteration 

loop.even: True if an even iteration 

loop.parity: "odd" or "even" depending on which is true 
loop.parent: the loop above this in nested loops 


有 时 候 ， 他 们 使 用 起 来 很 方便 : 


<table> 
$for C in kas "De pica Ride] : 
«tr class="$loop.parity"> 
<td>$loop.index</td> 
<td>$c</td> 
</tr> 
</table> 


其 他 


使 用 def 


可 以 使 用 $def 定义 一 个 新 的 模板 函数 ， 支 持 使 用 参数 。 


$def say hello(name-'world'): 
Hello $name! 


$say hello('web.py') 
$say hello() 


其 他 示例 : 


$def tr(values): 
<tr> 
$for v in values: 
<td>$v</td> 
</tr> 


$def table(rows): 
<table> 
$for row in rows: 
$:row 
</table> 


$ data = [['a', 'b', 'c'], [1, 2, 3], [2, 4, 6], [3, 6, 9] ] 
$:table([tr(d) for d in data]) 


代码 


可 以 在 code 块 书写 任何 python 代码 : $code: x = "you can write any python 
code here" y = x.title() z = len(x + y) 


def limit(s, width=10): 
"""limits a string to the given width""" 
if len(s) »- width: 
return s[:width] + "..." 
else: 
return s 


And we are back to template. 


The variables defined in the code block can be used here. 
For example, $limit(x) 


使 用 var 


var 块 可 以 用 来 定义 模板 结果 的 额外 属性 : 


$def with (title, body) 


$var title: $title 
$var content_type: text/html 


<div id="body"> 


$body 
</div> 


以 上 模板 内 容 的 输出 结果 如 下 : 


>>> out = render.page('hello', ‘hello world') 
>>> out.title 

u'hello' 

>>> out.content_type 

u'text/html' 

>>> str(out) 

"\n\n<div>\nhello world\n</div>\n' 


内 置 和 全 局 


像 python 的 任何 函数 一 样 ， 模 板 系统 同样 可 以 使 用 内 置 以 及 局 部 参数 。 很 多 内 置 
的 公共 方法 像 range ，min ， max 等 ， 以 及 布尔 值 True 和 False ， 在 模 
板 中 都 是 可 用 的 。 部 分 内 置 和 全 局 对 象 也 可 以 使 用 在 模板 中 。 


全 局 对 象 可 以 使 用 参数 方式 传 给 模板 ， 使 用 web. template. render 


import web 
import markdown 


globals = {'markdown': markdown.markdown} 


render = web.template.render('templates', globals=globals) 


内 置 方法 是 否 可 以 在 模板 中 也 是 可 以 被 控制 的 : 


# 禁用 所 有 内 置 方法 
render = web.template.render('templates', builtins={}) 


安全 
模板 的 设计 想法 之 一 是 允许 非 高 级 用 户 来 写 模 板 ， 如 果 要 使 模板 更 安全 ， 可 在 模板 
中 禁用 以 下 方法 : 

e 不 安全 部 分 像 import * exec 等 ; 

e 允许 属性 开始 部 分 使 用 s 

e 不 安全 的 内 置 方法 open, getattr , setattr ^» 


如 果 模 板 中 使 用 以 上 提 及 的 会 引发 异常 SecurityException ° 


从 web.py 0.2 升级 


新 版 本 大 部 分 兼容 早期 版 本 ， 但 仍 有 部 分 使 用 方法 会 无 法 运行 ， 看 看 以 下 原因 : 


e Template output is always storage like TemplateResult object, however 


converting it to unicode or str gives the result as unicode/string. 
e 重 定 义 全 局 变量 将 无 法 正常 运行 ， 如 果 X 是 全 局 变量 下 面 的 写法 是 无 法 运行 
的 。 


S xc us 


以 下 写法 仍 被 支持 ， 但 不 被 推荐 。 


e 如 果 你 原来 用 NS 反 转 美元 字符 串 ， 推 荐 用 $$ 替换 ; 
e 如 果 你 有 时 会 修改 web.template.Template.globals ， 建 议 通过 向 
web.template.render 传 变量 方式 来 替换 。 


站 点 布局 模板 


问题 

如 何 让 站 点 每 个 页 面 共享 一 个 整 站 范围 的 模板 ? (在 某 些 框架 中 ， 称 为 模板 继承 ， 
比如 ASPINET 中 的 母 版 页 ) 

方法 

我 们 可 以 用 base 属性 来 实现 : 


render = web.template.render('templates/', base='layout' ) 


现在 如 果 你 调用 render.foo() 方法 ， 将 会 加 载 templates/foo.html 模板 ， 
并 且 它 将 会 被 templates/layout.html 4X4 & € ° 


"layout.html" 是 一 个 简单 模板 格式 文件 ， 它 包含 了 一 个 模板 变量 ， 如 下 : 


$def with (content ) 
<html> 

<head> 

<title>Foo</title> 

</head> 

<body> 

$:content 

</body> 

</html> 


在 某 些 情 xc 如 果 不 想 使 用 基本 模板 ， 只 需要 创建 一 个 没有 base 属 性 的 reander 对 
象 ， 如 下 


render plain = web.template.render('templates/' ) 


Tip: 在 布局 文件 (layout.html) 中 定义 的 页 面 标题 变量 ， 如 何在 
其 他 模板 文件 中 赋值 ， 如 下 : 


templates/index.html 


$var title: This is title. 


<h3>Hello, world</h3> 


templates/layout.html 


$def with (content) 

<html> 

<head> 

<title>$content.title</title> 

</head> 

<body> 

$:content 

</body> 

</html> 


Tip: 在 其 他 模板 中 引用 css 文 件 ， 如 下 : 
templates/login.html 


$var cssfiles: static/login.css static/login2.css 


hello, world. 


templates/layout.html 


$def with (content) 

<html> 

<head> 
<title>$content.title</title> 


$if content.cssfiles: 
$for f in content.cssfiles.split(): 
<link rel="stylesheet" href="$f" type="text/css" media: 


</head> 
<body> 
$:content 
</body> 
</html> 





输入 的 HTML 代 码 如 下 : 


<link rel="stylesheet" href="static/login.css" type="text/css" med: 
<link rel="stylesheet" href="static/login2.css" type="text/css" mec 


‘ — 








交替 风格 


你 想 通过 数据 集合 动态 的 生成 交替 背景 色 的 列表 . 


YS 


方法 : 


Give templetor access to the int built-in and use modulo to test. 


code.py 


web.template.Template.globals['int'] = int 


template.html 
«ul» 
$var i: O 


$for track in tracks: 
$var i: ${int(self.i) + 1} 
<li class=" 
$if int(self.i) % 2: 
odd 
$else: 
even 
"S$track.title</li> 
</ul> 


New Templetor 


In the new implementation of templetor (which will be the default when version .3 
is released), within any template loop you have access to a $loop variable. This 


works like so: 


<ul> 

$for foo in foos: 
<li class="$loop.parity"> 
$foo 
</li> 

</ul> 


Import functions into templates 


Problem : How can | import a python module in template? 
Solution : 


While you write templates, inevitably you will need to write some functions which 
is related to display logic only. web.py gives you the flexibility to write large blocks 
of code, including defining functions, directly in the template using $code blocks 
(if you don't know what is $code block, please read the tutorial for Templator first). 
For example, the following code block will translate a status code from database 
to a human readable status message: 


def status(c): 


st = {} 

st[0] = 'Not Started' 
st[1] = 'In Progress' 
st[2] = 'Finished' 


return st[c] 


As you do more web.py development, you will write more such functions here and 
there in your templates. This makes the template messy and is a violation of the 
DRY (Don't Repeat Yourself) principle. 


Naturally, you will want to write a module, say displayLogic.py and import that 
module into every templates that needs such functionalities. Unfortunately, 

import is disabled in template for security reason. However, it is easy to solve 
this problem, you can import any function via the global namespace into the 
template: 


#in your application.py: 
def status(c): 


st = {} 

st[0] = 'Not Started' 
st[1] = 'In Progress' 
st[2] = 'Finished' 


return st[c] 
render = web.template.render('templates', globals={'stat':status}) 


#in the template: 
$def with(status) 


<div>Status: $stat(status)</div> 








Remember that you can import more than one name into the globals dict. This 
trick is also used in importing session variable into template. 


i18n support in template file 
模板 文件 中 的 i18n 支 持 


Je] eh: 


在 web.py 的 模板 文件 中 , 如 何 得 到 i18n 的 支持 ? 


Solution: 


项 目 目录 结构 : 


proj/ 
|- code.py 
|- i18n/ 
|- messages.po 
|- en US/ 
|- LC MESSAGES/ 
|- messages.po 
|- messages.mo 
|- templates/ 
|- hello.html 


文件 : proj/code.py 


#!/usr/bin/env python 
# encoding: utf-8 


import web 
import gettext 


# File location directory. 
curdir = os.path.abspath(os.path.dirname( file )) 


# i18n directory. 
localedir = curdir + '/ii18n' 


gettext.install('messages', localedir, unicode-True) 
gettext.translation('messages', localedir, languages-['en US']).in: 
render = web.template.render(curdir + '/templates/', globals-(' ': 


class hello: 
def GET(self): 
return render.hello() 


# 使 用 内 建 的 HTTP 服 务 器 来 运行 ， 
app = web.application(urls, globals() ) 
if _name__ == " main ": 

app.run() 


SS SS SSS ESS 


模板 文件 : proj/templates/hello.html. 





$ ("Message") 


建 一 -个 locale 目录 并 使 用 python2.6 内 建 的 pygettext.py 从 python 脚 本 和 模板 文件 中 
dB 


shell» cd /path/to/proj/ 

shell» mkdir -p i18n/en US/LC MESSAGES/ 

shell» python /path/to/pygettext.py -a -v -d messages -o i18n/mess: 
Working on code.py 

Working on templates/hello.html 


CE ——————— mH] 


你 将 会 得 到 pot file: i18n/messages.po. 它 的 内 容 和 下 面 的 差不多 (msgstr éA f &i 
译 后 的 信息 ): 





# 文件 code.py:40 
msgid "Message" 


msgstr "This is translated message in file: code.py." 


45 W x: 4#'i18n/messages.po'?| H xt'if8n/en US/LC. MESSAGES/'T, 然后 翻译 它 . 


使 用 gettext 包 的 msgfmt 工 具 或 者 使 用 python2.6 内 建 的 'msgfmt.py' 文 件 将 一 个 pot 文 
件 编译 称 mo 文 件 : 


shell» msgfmt -o ii18n/en US/LC MESSAGES/messages.mo i18n/en_US/LC_} 


al 








运行 Web.py 的 服务 器 : 


shell> cd /path/to/proj/ 
shell> python code.py 
http://0.0.0.0:8000/ 


打开 你 的 浏览 器 , 比如 说 firefox, 然后 访问 地 址 : http://192.168.0.3:8000/, 你 将 会 看 
过 翻译 过 的 信息 . 


在 webpy 中 使 用 Mako 模 板 引擎 
问题 

如 何在 webpy 中 使 用 Mako 模 板 引 擎 ? 

解决 方案 


首先 需要 安装 Mako 和 web.py(0.3):http://www.makotemplates.org/ 然后 尝试 下 面 的 
代码 : 


# encoding: utf-8 
# File: code.py 
import web 
from web.contrib.template import render_mako 
urls = ( 
Uy "hello! 
) 
app - web.application(urls, globals(), autoreload-True) 
# input encoding and output encoding is important for unicode 
# template file. Reference: 
# http://www.makotemplates.org/docs/documentation.html#unicode 
render - render mako( 
directories=['templates'], 
input encoding-'utf-8', 
output encoding-'utf-8', 


) 


class hello: 
def GET(self, name): 
return render.hello(name-name) 
# Another way: 
#return render.hello(**locals()) 


if | name == " main ": 
app.run() 
模板 文件 


## File: templates/hello.html 


Hello, ${name}. 


如 果 你 使 用 Apache+mod wsgi 来 部 署 webpy 程 序 , 你 也 许 会 在 Apache 错 误 日 志 中 得 
到 下 面 的 错误 信息 : [Sat Jun 21 21:56:22 2008] [error] [client 192.168.122.1] 
TopLevelLookupException: Cant locate template for uri ‘index.html’ 


你 必须 使 用 绝对 路 径 指 出 模板 的 位 置 . 你 也 可 以 使 用 相对 路 径 来 让 它 更 简单 一 些 : 


import os 


render = render_mako( 
directories=[os.path.join(os.path.dirname(__file__), 'temp. 
input_encoding='utf-8', 
output_encoding='utf-8', 





http://code.google.com/p/modwsgi/wiki/Applicationlssues 


在 webpy 中 使 用 Cheetah 模 板 引 擎 
问题 : 

怎样 在 webpy 中 使 用 Cheetah 模 板 引擎 ? 

解决 : 


您 需要 先 安装 webpy(0.3) 和 Cheetah : http://www.cheetahtemplate.org/. 然后 尝试 
使 用 下 面 的 代码 段 : 


# encoding: utf-8 
# File: code.py 


import web 
from web.contrib.template import render_cheetah 


render = render_cheetah('templates/' ) 


urls = ( 
(hrs). hairs’, 
'/(second)', 'second' 


) 
app = web.application(urls, globals(), web.reloader) 


class first: 
def GET(self, name): 
# cheetah template takes only keyword arguments, 
# you should call it as: 
# return render .hello(name=name ) 
# Below is incorrect: 
# return render .hello(name) 
return render.first(name-name) 


class second: 
def GET(self, name): 
return render.first(**locals()) 


if | name == " main ": 
app.run() 


模板 文件 


## File: templates/first.html 


hello, $name. 


Use Jinja2 template engine in webpy 


问题 
如 何在 web.py 中 使 用 Jinja2 (http://jinja.pocoo.org/2/) 模板 引擎 ? 
方案 
首先 需要 安装 Jinja2 和 webpy(0.3), 然后 使 用 下 面 的 代码 做 测试 : 
import web 
from web.contrib.template import render_jinja 
urls = ( 
A jig held! 
) 
app - web.application(urls, globals()) 
render - render jinja( 
'templates', # 设置 模板 路 径 . 
encoding = 'utf-8', # 编码 ， 
) 


# 添 加 或 者 修改 一 些 全 局 方法 ， 
Zrender. lookup.globals.update( 


# var=newvar, 
# var2=newvar2, 
#) 


class hello: 
def GET(self, name): 
return render.hello(name=name) 


if | name == n main_": 
app.run() 


模板 文件 : templates/hello.html 


Hello, 


How to use templates on Google App Engine 


Je] xe 
如 何在 Google App Engine 上 使 用 模板 


Je 


解答 
web.py templetor 把 模板 编译 成 python 字 节 码 ， 这 需要 访问 标准 库 中 的 parser 模 
块 。 不 幸 的 是 ， 由 于 安全 原因 GAE 禁用 了 这 个 模块 。 


为 了 克服 这 个 状况 ，Web.py 支持 把 模板 编译 成 python 代码 ， 从 而 避免 在 GAE 上 
使 用 原来 的 模板 。web.py 确保 在 应 用 这 种 方法 的 时 候 模 板 中 的 代码 不 需要 任何 改 


dk 
X? 


为 了 编译 一 个 文件 夹 中 所 有 的 模板 (一旦 有 模板 改动 ， 就 需要 重新 运行 ) ， 运 行 : 
$ python web/template.py --compile templates 
以 上 命令 把 templates/ 目录 下 的 模板 文件 递归 地 全 部 编译 ， 并 且 生 产 


. init .py * 'web.template.render 重新 编写 过 ， 它 将 视 templates 为 一 个 
python 模块 。 


Testing 测试 


Testing with Paste and Nose 


Problem 


You want to test your web.py application. 
Solution 


from paste.fixture import TestApp 
from nose.tools import * 
from code import app 


class TestCode(): 
def test_index(self): 
middleware = [] 
app = TestApp(app.wsgifunc(*middleware)) 
r = app.get('/') 
assert_equal(r.status, 200) 
r.mustcontain('Hello, world!') 


Background 


This example makes use of the Paste and Nose libraries. Paste lets you throw 
test requests at your application, and adds some helpful custom methods to the 
response objects, such as mustcontain(), seen above. Nose makes writing and 
running your tests dead simple. When run from the base of your tree, it 
automatically finds and runs anything which is named like a test, adding 
necessary modules to your PYTHONPATH. This gives you the flexibility to run 
your tests from other directories, as well. Another benefit of Nose is that you no 
longer need to have every test class inherit from unittest. TestCase. Many more 
details are outlined on the project page. 


Explanation 


This code resides in a file called test code.py. The directory layout of the 
application looks like this: 


ut 
code.py 
./test 
test code.py 


Most of the code example above should be fairly self-explanatory. From our main 
module, code, we import app, which is defined in the usual way: 


app - web.application(urls, globals()) 


To set up the test, we pass its wsgifunc() to Paste's TestApp, as you have already 
seen in the example. 


app - TestApp(app.wsgifunc(*middleware)) 


assert equal() is one of the methods provided by nose's utils, and works just like 
unittest's assertEqual(). 


Setting Up the Test Environment 


In order to avoid kicking off web.py's webserver when we run our tests, a change 
is required to the line which calls run(). It normally looks something like this: 


if | name == " main ": app.run() 


We can define an environment variable, such as WEBPY_ENV=test, when we run 
our tests. In that case, the above line becomes the following: 


import os 
def is test(): 
if 'WEBPY ENV' in os.environ: 
return os.environ['WEBPY ENV'] -- 'test' 


if (not is test()) and name == " main ^": app.run() 


Then, its simply a matter of running nosetests like so: 


WEBPY ENV-test nosetests 


The is_test() function comes in handy for other things, such as doing conditional 
database commits to avoid test database pollution. 


RESTful doctesting using app.request 


## !/usr/bin/env python 


RESTful web.py testing 
usage: python webapp.py 8080 [--test] 


>>> req = app.request('/mathematicians', method='POST' ) 
>>> req.status 
'400 Bad Request' 


>>> name {'first': 'Beno\xc3\xaet', 'last': 'Mandelbrot'} 

>>> data = urllib.urlencode(name) 

>>> req = app.request('/mathematicians', method='POST', data=data) 
>>> req.status 

'201 Created' 

>>> created path = req.headers['Location' | 

>>> created_path 

'/mathematicians/b-mandelbrot' 

>>> fn = '<hi class-fn»(0) (ij)«/hi»'.format(name['first'], name['l: 
>>> assert fn in app.request(created_path).data 


import doctest 
import urllib 
import sys 


import web 


paths = ( 
'/mathematicians(/)?', 'Mathematicians', 
'/mathematicians/([a-z])-([a-z]{2,})', 'Mathematician' 


) 
app - web.application(paths, globals()) 


dbname = (True: 'test', False: 'production'}[sys.argv[-1] == '--te: 
db = {} # db = web.database(..., db='math_{0}'.format(dbname) ) 


class Mathematicians: 


def GET(self, slash=False): 
"""list all mathematicians and form to create new one""" 
if slash: 
raise web.seeother('/mathematicians' ) 
mathematicians = db.items() # db.select(...) 
return web.template.Template("""$def with (mathematicians) 


<!doctype html> 
<html> 
<head> 
<meta charset=utf-8> 
<title>Mathematicians</title> 
</head> 
<body> 
<hi>Mathematicians</h1> 
$if mathematicians: 
<ul class=blogroll> 
$for path, name in mathematicians: 
<li class=vcard><a class="fn url" 
href=/mathematicians/$path>$name. first $name. last</a: 
</ul> 
<form action=/mathematicians method=post> 
<label>First <input name=first type=text></label> 
<label>Last <input name=last type=text></label> 
<input type=submit value=Add> 
</form> 
</body> 
</htm1>""") (mathematicians) 


def POST(self, _): 
"""create new mathematician""" 
name - web.input('first', 'last') 
key = '{0}-{1}'.format(name.first[0].lower(), name.last.lower(: 
name.first, name.last - name.first.capitalize(), name.last.cap: 
db[key] = name # db.insert(...) 
path = '/mathematicians/{0}'.format(key) 
web.ctx.status - '201 Created' 
web.header('Location', path) 
return web.template.Template("""$def with (path, name) 
<!doctype html> 
<html> 
<head> 
<meta charset=utf-8> 
<title>Profile Created</title> 
</head> 
<body> 
<p>Profile created for <a href=$path>$name.first $name. lasi 
</body> 
</html>""")(path, name) 


class Mathematician: 


def GET(self, first_initial, last_name): 

"""display mathematician""" 
key = '{0}-{1}'.format(first_initial, last_name) 
try: 

mathematician = db[key] # db.select(...) 
except KeyError: 

raise web.notfound() 
return web.template.Template("""$def with (name) 


<!doctype html> 
<html> 
<head> 
«meta charset=utf -8> 
<title>$name.first $name. last</title> 
</head> 
<body class=vcard> 
<p><a href-/mathematicians rel=up>Mathematicians</a> &#x25I 
«hi class=fn>$name.first $name.last</h1> 
</body> 
</htm1>""") (mathematician) 
if _name__ == "__main_": 
if sys.argv[-1] == '--test': 
doctest.testmod( ) 
else: 


app.run() 
ers SERRE TES 





User input 用 户 输入 


File Upload Recipe 


问题 


如 果 你 不 是 很 了 解 表单 上 传 或 者 CGI 的 话 , 你 会 觉得 文件 上 传 有 点 奇特 ， 
解决 方法 


import web 
urls = ('/upload', 'Upload') 


class Upload: 
def GET(self): 
return """<html><head></head><body> 
<form method="POST" enctype="multipart/form-data" action=""> 
<input type="file" name="myfile" /> 


<br/> 

<input type="submit" /> 
</form> 
</body></htm1>""" 


def POST(self): 
x = web.input(myfile-()) 
web.debug(x['myfile'].filename) # 这 里 是 文件 名 
web.debug(x['myfile'].value) # 这 里 是 文件 内 容 
web.debug(x['myfile'].file.read()) # 或 者 使 用 一 个 文件 对 象 
raise web.seeother('/upload' ) 


if name == " main_": 
app = web.application(urls, globals()) 
app.run() 
需要 注意 以 下 内 容 : 


e 表单 需要 一 个 enctype="multipart/form-data" 的 属性 , 否则 不 会 正常 工作 . 
。 在 Webpy 的 代码 里 , 如 果 你 需要 默认 值 的 话 , myfile 就 需要 默认 值 了 (myfile= 人 })， 
文件 会 以 字符 串 的 形式 传输 -- 这 确实 可 以 工作 , 但 是 你 会 丢失 文件 的 名 称 


保存 上 传 的 文件 


问题 


上 传 文件 ， 并 将 其 保存 到 预先 设 定 的 某 个 目录 下 。 
方法 


import web 
urls = ('/upload', 'Upload') 


class Upload: 
def GET(self): 
web.header("Content-Type", "text/html; charset=utf-8") 
return """<html><head></head><body> 
<form method="POST" enctype="multipart/form-data" action=""> 
<input type="file" name="myfile" /> 


<br/> 

<input type="submit" /> 
</form> 
</body></htm1>""" 


def POST(self): 

x = web. input (myfile={}) 

filedir = '/path/where/you/want/to/save' # change this to 1 

if 'myfile' in x: # to check if the file-object is created 
filepath=x.myfile.filename.replace('\\','/') # replace: 
filename-filepath.split('/')[-1] # splits the and choo: 
fout = open(filedir +'/'+ filename, 'w') # creates the 1 
fout.write(x.myfile.file.read()) # writes the uploaded 
fout.close() # closes the file, upload complete. 

raise web.seeother('/upload') 


if | name == " main ": 
app - web.application(urls, globals()) 
app.run() 





Hang ups 


同时 还 需要 注意 如 下 几 点 : 
e 转 到 fileupload ° 


e 千 万 不 要 让 用 户 把 文件 上 传 到 那些 不 经 过 文件 后 级 和 类 型 检查 而 执行 文件 的 文 
件 夹 下 。 

e 事实 上 ， 一 定 要 以 "mb" 模 式 打开 文件 (在 windows 下 ) ， 也 就 是 二 进 制 可 写 模 
式 , 否则 图 片 将 无 法 上 传 。 


EA SA SIRE 


问题 


如 何 限定 上 传 文件 的 大 小 ? 


Solution 


web.py 使 用 cgi 模块 来 解析 用 户 的 输入 ， 而 cgi 模块 对 最 大 输入 大 小 有 限 
il] o 


下 面 的 代码 限制 了 最 大 数据 输入 为 10MB. 


import cgi 


# Maximum input we will accept when REQUEST_METHOD is POST 
# 9 ==> unlimited input 
cgi.maxlen = 10 * 1024 * 1024 # 10MB 


请 注意 这 是 对 POST 方法 提交 数据 大 小 的 限制 ， 而 不 是 上 传 文件 大 小 。 当 然 如 果 表 
单 中 没有 其 他 输入 数据 ， 上 传 文件 完全 可 以 达到 限制 的 大 小 。 


cgi 模块 将 会 抛 出 ValueError 异常 ， 如 果 数 据 输 入 的 大 小 超过 了 
cgi.maxlen 。 我 们 可 以 捕捉 该 异常 而 避免 显示 不 友好 的 错误 信息 。 


class upload: 
def POST(self): 
try: 
i = web.input(file={}) 
except ValueError: 
return "File too large" 


web.input 


web.input 


问题 


如 何 从 form 或 是 url 参 数 接 受用 户 数据 . 
解决 方法 


Web.input() 方 法 返回 一 个 包含 从 url(GET 方 法 ) 或 http header(POST 方 法 , 即 表单 
POST) 获 取 的 变量 的 web.storage 对 象 (类 似 字 典 ). 举 个 例子 ,如 果 你 访问 页 面 
http://example.com/test?id=10, 在 Python 后 人 台 你 想 取 得 id=10 ,那么 通过 web.input() 
那 就 是 小 菜 一 碟 : 


class SomePage: 
def GET(self): 
user_data = web.input() 
return "<hi>" + user data.id + "</h1>" 


有 时 你 想 指 定 一 个 默认 变量 ,而 不 想 使 用 None. 参 考 下 面 的 代码 : 


class SomePage: 
def GET(self): 
user_data = web.input(id="no data") 
return "<hi>" + user data.id + "</h1i>" 


注意 ,Web.input() 取 得 的 值 都 会 被 当 作 string 类 型 ,即使 你 传递 的 是 一 些 数字 . 
如 果 你 想 传 递 一 个 多 值 变 量 ,比如 像 这 样 : 


<select multiple="" size="3"><option>foo</option><option>bar</option> 
<option>baz</option></select> 


你 需要 让 Web.input 知 道 这 是 一 个 多 值 变量 ,否则 会 变 成 一 串 而 不 是 一 个 变量 .传递 一 
个 list 给 web.input 作为 默认 值 ,就 会 正常 工作 . 举 个 例子 , 访问 http://example.com? 
id=10&id=20: 


class SomePage: 
def GET(self): 
user data = web.input(id-[]) 
return "<hi>" + ",",join(user data.id) + "«/hi»" 


译 者 补充 : 多 值 变量 这 几 , 在 WEB 上 除了 上 面 所 说 的 multiple select 和 query strings 
外 ,用 得 最 多 的 就 是 复 选 框 (checkbox) 了 ,另外 还 有 多 文件 上 传 时 的 <input type="file" 
了 


怎样 使 用 表单 forms 


le] el: 


怎样 使 用 表单 forms 
解决 : 


'Web.form' 模 块 提供 支持 创建 ， 校 验 和 显示 表单 。 该 模块 包含 一 个 'Form' 类 和 各 种 输 


入 框 类 如 'Textbox' > 'Password'= = ° 


当 'form.validates()" 调 用 时 ， 可 以 针对 每 个 输入 检测 的 哪个 是 有 效 的 ， 并 取得 校 验 理 
由 列表 。 


'Form' 类 同样 可 以 使 用 完整 输入 附加 的 关键 字 参 数 'validators' 来 校 验 表单 。 
这 里 是 一 个 新 用 户 注 册 的 表单 的 示例 : 


import web 
from web import form 


render = web.template.render('templates') # your templates 


vpass = form.regexp(r".{3,20}$", 'must be between 3 and 20 characte 
vemail = form.regexp(r".*@.*", "must be a valid email address") 


register form = form. Form( 
form.Textbox("username", description="Username"), 
form.Textbox("email", vemail, description="E-Mail"), 
form.Password("password", vpass, description="Password"), 
form.Password("password2", description="Repeat password"), 
form.Button("submit", type="Submit", description="Register"), 
validators = [ 

form.Validator("Passwords did't match", lambda i: i.passwo! 


) 


class register: 
def GET(self): 
# do $:f.render() in the template 
f = register_form() 
return render.register(f) 


def POST(self): 
f - register form() 
if not f.validates(): 
return render.register(f) 
else: 
# do whatever is required for registration 





然后 注册 的 模板 应 该 像 是 这 样 : 


$def with(form) 


<hi>Register</h1i> 
<form method="POST"> 

$:form. render () 
</form> 


问题 : 
怎样 在 模板 中 个 别 显 示 表 单字 段 ? 
解决 : 
你 可 以 使 用 render()' 方 法 在 你 的 模板 中 显示 部 分 的 表单 字段 。 


假设 你 想 创 建 一 个 名 字 / 姓 氏 表 单 。 很 简单 ， 只 有 两 个 字段 ， 不 需要 验证 ， 只 是 为 了 
测试 目的 。 


from web import form 

simple_form = form.Form( 
form.Textbox('name', description='Name'), 
form.Textbox('surname', description='Surname'), 


常 你 可 以 使 用 simple form.render () 或 simple form.render css () 。 
果 你 或 者 你 怎样 才能 对 模板 中 的 表单 显示 拥 
有 更 多 的 控制 权限 ? 如 果 是 这 样 ， 你 可 以 对 你 的 个 别 字段 使 用 render() 方法 。 


我 们 定义 了 两 个 字段 名 称 为 name 和 surname 。 这 些 名 称 将 自动 成 
为 simple form 对 象 的 属性 。 


>>> simple form.name.render() 

"<input type="text" name="name" id="name" /»' 

>>> simple _form.surname. render () 

"<input type="text" name-"surname" id="Surname" />' 


你 同样 可 以 通过 类 似 的 方法 显示 个 别 的 描述 : 


>>> simple form.surname.description 
'Surname' 


如 果 你 有 一 个 小 模板 片段 (局 部 模板 ) ， 你 想 统一 的 使 用 你 所 定义 的 所 有 表单 字 
B? 你 可 以 使 用 表单 对 象 的 inputs 属性 迭代 每 个 字段 。 下 面 是 一 个 示例 : 


>>> for input in simple form.inputs: 
print input.description 
print input.render() 
Name 
<input type="text" name="name" id="name" /> 


Surname 
<input type="text" name-"surname" id="Surname" /> 


Database 数据 库 


多 数据 库 使 用 


问题 


如 何在 单独 项 目 中 应 用 多 数据 库 ? 


解决 办 法 


webpy 0.3 支持 多 数据 库 操 作 , 并 从 web 模 块 中 移 走 数据 库 部 分 , 使 其 成 为 一 个 更 典 
型 的 对 象 . 例子 如 下 : 
import web 


dbi 
db2 


web.database(dbn-'mysql', db-'dbnamei1', user='foo' ) 
web.database(dbn-'mysql', db='dbname2', user='foo' ) 


print dbi.select('foo', where='id=1 
print db2.select('bar', where='id=5 


E) 
Ss) 


增加 , 更 新 , 删除 和 查询 的 方法 跟 原 有 单数 据 库 操作 类 似 . 
当然 , 你 可 以 使 用 host 和 port 参 数 来 指定 服务 器 地 址 和 监听 端口 . 


db.select 查询 


问题 ，: 

怎样 执行 数据 库 查 询 ? 

解决 方案 : 

如 果 是 0.3 版 本 , 连接 部 分 大 致 如 下 : 


db = web.database(dbn='postgres', db='mydata', user='dbuser', pw=' 
P| 
当 获 取 数 据 库 连接 后 , 可 以 这 样 执行 查询 数据 库 : 





# Select all entries from table 'mytable' 
entries = db.select('mytable') 


select 方 法 有 下 面 几 个 参数 : 


e vars 
e what 
e where 
e order 
e group 
e limit 
e offset 
e test 


vars 


Vvars 变 量 用 来 填充 查询 条 件 . 如 : 


myvar = dict(name="Bob" ) 
results = db.select('mytable', myvar, where="name = $name") 


what 


What 是 标明 需要 查询 的 列 名 , 默认 是 *, 但 是 你 可 以 标明 需要 查询 哪些 列 . 


results = db.select('mytable', what="id, name") 


where 


where #14 & fF, 如 : 


results = db.select('mytable', where="id>100" ) 


order 
排序 方式 : 


results = db.select('mytable', order="post_date DESC") 


group 
按 group 组 排列 . 


results = db.select('mytable', group="color") 
limit 
从 多 行 中 返回 limit 查 询 ， 


results = db.select('mytable', limit-10) 


offset 


偏 移 量 , 从 第 几 行 开始 . 


results = db.select('mytable', offset=10) 


_test 


查看 运行 时 执行 的 SQL 语句: 


results = db.select('mytable', offset=10, _test=True) 
<sql: 'SELECT * FROM mytable OFFSET 10'> 
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db.upate 数据 更 新 
问题 

向 数据 库 中 更 新 数据 。 
解决 方案 


import web 


db = web.database(dbn='postgres', db='mydata', user='dbuser', pw=' 
db.update('mytable', where="id = 10", valuei = "foo") 


在 查询 中 有 更 多 关于 可 用 参数 的 信息 。 
该 更 新 操作 会 返回 更 新 的 影响 行 数 。 





db.delete 数据 删除 


问题 


在 数据 库 中 删除 数据 。 
解决 办 法 


import web 


db = web.database(dbn='postgres', db='mydata', user='dbuser', pw=' 
db.delete('mytable', where="id=10") 


上 面 接受 "using" 和 "vars" 参数 。 
删除 方法 返回 被 删除 的 影响 行 数 。 





db.insert 向 数据 库 中 新 增 数 据 
问题 

如 何 向 数据 如 新 增 数 据 ? 

解决 办 法 

在 0.3 中 ， 数 据 库 连 接 如 下 : 


db = web.database(dbn='postgres', db='mydata', user='dbuser', pw=' 
数据 库 连 接 写 好 以 后 "insert" 操作 如 下 : 





# 向 'mytable' 表 中 插入 一 条 数据 
sequence_id = db.insert('mytable', firstname="Bob", lastname="Smith' 


a] ie 
上 面 的 操作 带 入 了 几 个 参数 ， 我 们 来 说 明 一 下 : 


tablename 
seqname 
_test 
**values 





tablename 


表 名 ， 即 你 希望 向 哪个 表 新 增 数据 。 


seqname 


可 选 参数 ， 默 认 None Set seqname to the ID if it's not the default, or to 
False . 


_test 


_test 参数 可 以 让 你 看 到 SQL 的 执行 过 程 : 


results 
><sql: 


字段 参数 。 


= db.select('mytable', offset-10, _test=True) 
"SELECT * FROM mytable OFFSET 10'> 


如 果 没 有 赋值 ， 数 据 库 可 能 创建 默认 值 或 者 发 出 警告 。 


使 用 db.query 进 行 高 级 数据 库 查 询 


问题 : 

您 要 执行 的 SQL 语句 如 : 高 级 的 联接 或 计数 。 

解决 : 

Wwebpy 不 会 尝试 为 您 和 您 的 数据 库 建立 层 。 相 反 ， 它 试图 以 方便 的 通用 任务 ， 走 出 


自己 的 方式 ， 当 您 需要 做 的 更 高 级 的 主题 。 执 行 高 级 的 数据 库 查询 是 没有 什么 不 
同 。 例 如 : 


import web 
db = web.database(dbn='postgres', db='mydata', user='dbuser', pw=' 


results = db.query("SELECT COUNT(*) AS total_users FROM users") 
print results[0].total users # -> prints number of entries in 'use! 


i 
或 者 是 ， 使 用 一 个 JOIN 示例 : 





import web 


db = web.database(dbn='postgres', db='mydata', user='dbuser', pw=' 


results = db.query("SELECT * FROM entries JOIN users WHERE entries 





为 了 防止 SQL 注入 攻击 ，db.query 还 接受 了 “vars" 语 法 如 下 描述 db.select: 


results = db.query("SELECT * FROM users WHERE id=$id", vars={'id':: 


[e] 





这 将 避免 用 户 输入 ， 如 果 你 信任 这 个 “id" 变 量 。 


怎样 使 用 数据 库 事务 处 理 


问题 : 
怎样 使 用 数据 库 事务 处 理 ? 
解决 : 


数据 库 对 象 有 一 个 方法 “transaction”, 将 启动 一 个 新 的 事务 ， 并 返回 事务 对 象 。 
事务 对 象 可 以 使 用 commit 提 交 事 务 或 rollback 来 回 滚 事务 。 


Bk 
> 


import web 


db = web.database(dbn="postgres", db="webpy", user="foo", pw="") 
t = db.transaction() 
try: 
db.insert('person', name='foo' ) 
db.insert('person', name='bar' ) 
except: 
t.rollback() 
raise 
else: 
t.commit() 


python 2.5+ 以 上 的 版 本 ， 事 务 同样 可 以 在 段 中 使 用 : 


from _ future . import with statement 
db = web.databse(dbn="postgres", db="webpy", user="foo", pw="") 
with db.transaction(): 


db.insert('person', name='foo' ) 
db.insert('person', name='bar' ) 


CART REA — PRE RAE : 


def post(title, body, tags): 
t = db.transaction() 


try: 
post id = db.insert('post', title-title, body=body) 
add tags(post id, tags) 
except: 
t.rollback() 
else: 
t.commit( ) 


def add tags(post id, tags): 

t - db.transaction() 
try: 

for tag in tags: 

db.insert('tag', post id-post id, tag-tag) 

except: 

t.rollback() 
else: 

t.commit () 


点 套 的 事务 在 sqlite 中 将 被 忽略 ， 因 为 此 特性 不 被 sqlite 支 持 。 


sqlalchemy 


癌 题 
如 何在 web.py 中 使 用 sqlalchemy 
方案 


创建 一 个 钩子 并 使 用 sqlalchemy 的 scoped session 
(http://www.sqlalchemy.org/docs/05/session.html#unitofwork_contextual) 


import string 
import random 
import web 


from sqlalchemy.orm import scoped_session, sessionmaker 
from models import * 


urls = ( 
soy ais "add", 
"/view", "view" 


) 


def load sqla(handler): 
web.ctx.orm = scoped session(sessionmaker(bind-engine)) 
try: 
return handler() 
except web.HTTPError: 
web.ctx.orm.commit ( ) 
raise 
except: 
web.ctx.orm.rollback() 
raise 
finally: 
web.ctx.orm.commit() 


app - web.application(urls, locals()) 
app.add processor(load sqla) 


class add: 
def GET(self): 
web.header('Content-type', 'text/html') 


fname = "".join(random.choice(string.letters) for i in rant 
lname = "".join(random.choice(string.letters) for i in rang 
u = User(name-fname 

,fullname=fname + ' ' + lname 


, password =542) 
web.ctx.orm.add(u) 
return "added:" + web.websafe(str(u)) 和 
+ "<br/>" N 
+ '<a href="/view">view all</a>' 


class view: 
def GET(self): 
web.header('Content-type', 'text/plain') 
return "\n".join(map(str, web.ctx.orm.query(User).all())) 


if name == " main ": 
app.run() 


«| m 








models.py 


from sqlalchemy import create_engine 
from sqlalchemy import Column, Integer, String 


engine = create_engine('sqlite:///mydatabase.db', echo=True) 
from sqlalchemy.ext.declarative import declarative_base 


Base = declarative base() 
class User(Base): 
__tablename__ = 'users' 


id = Column(Integer, primary_key=True) 
name = Column(String) 

fullname = Column(String) 

password = Column(String) 


def _ init (self, name, fullname, password): 
self.name = name 
self.fullname = fullname 
self.password = password 


def _ repr (self): 
return "<User('%s','%s', '%S')>" % (self.name, self .fullname 


users table = User. table . 
metadata - Base.metadata 


if | name == " main ": 
metadata.create all(engine) 


EE m 


在 跑 程序 之 前 ,运行 'python models.py' 来 初始 化 一 次 数据 库 . 





整合 SQLite UDF (A P xx 3: 44) 到 webpy 数据 
库 层 

问题 : 

用 户 在 邮件 列表 中 询问 ， 我 把 它 放 在 这 里 作为 将 来 使 用 和 参考 。 

解决 : 

您 可 以 添加 到 Python 函 数 到 SQLite， 并 让 它们 在 您 的 查询 调用 。 

示例 : 


>>> import sqlite3 as db 
>>> conn = db.connect(":memory:") 


>>> conn.create_function("sign", 1, lambda val: val and (val > 0 ar 


>>> Cur = conn.cursor() 

>>> cur.execute("select 1, -1") 
<sqlite3.Cursor object at Oxb759f2c0> 
>>> print cur.fetchall() 


[(1, -1)] 


>>> cur.execute("select sign(1), sign(-1), sign(0), sign(-99), sig! 


«sqlite3.Cursor object at Oxb759f2c0> 
>>> print cur.fetchall() 

[ (1, -1, 0, -1, 1)] 

>>> conn.close() 
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在 webpy 中 ， 你 可 以 通过 游标 如 db. db cursor().connection 取得 连接 对 象 的 引用 。 


示例 : 


>>> import web 
>>> db = web.database(dbn="sqlite", db=":memory:") 





>>> db._db_cursor().connection.create_function("sign", 1, lambda Vi 


>>> print db.query("select sign(1), sign(-1), sign(0), sign(-99), 


[<Storage {'sign(1)': 1, 'sign(-1)': -1, 'sign(99)': 1, 'sign(-99) 


El = : 


€ 





使 用 字典 动态 构造 Where 子 幻 


你 希望 创建 一 个 字典 来 构造 动态 的 where 子 名 并 且 希 望 能 够 在 查询 语句 中 使 用 。 


>>> import web 

>>> db = web.database(dbn='postgres', db='mydb', user='postgres' ) 
>>> where dict = ['coli': 1, col2: 'sometext'} 

>>> db.delete('mytable', where=web.db.sqlwhere(where_dict), _test= 
«sql: "DELETE FROM mytable WHERE coli = 1 AND col2 = 'sometext'"> 





解释 


web.db.sqlwhere takes a Python dictionary as an argument and converts it into 
a string useful for where clause in different queries. You can also use an optional 

grouping argument to define the exact gouping of the individual keys. For 
instance: 


web.db.sqlwhere 将 Python 的 字典 作为 参数 并 且 转 换 为 适用 于 不 同 的 查询 语 多 的 


Where 子 名 的 string 类 型 数据 。 你 也 可 以 使 用 grouping 参数 来 定义 链接 字典 中 的 
key 的 链接 字符 。 例 子 如 下 。 


>>> import web 
>>> web.db.sqlwhere({'a': 1, 'b': 2}, grouping=' OR ') 
"a = 1 OR b = 2' 


grouping 的 默认 值 为 ' AND ' . 


Deployment 部 署 


通过 Fastcgi 和 lighttpd 部 署 


如 果 你 对 这 个 主题 有 任何 问题 ， 可 以 点 击 下 面 的 链接 访问 相应 的 话题 : 
http://www.mail-archive.com/webpy@googlegroups.com/msg02800.html 
下 面 的 代码 基于 lighttpd 1.4.18， 更 高 版 本 也 可 以 工作 


Note: 


你 可 以 重 命名 code.py 为 任何 你 自己 愿意 的 名 字 ， 该 例子 还 是 以 code.py 为 
例 o 

e /path-to/webpy-app 为 包含 你 的 code.py 代码 的 路 径 

e /path-to/webpy-app/code.py 应 该 是 你 的 python files) X 4345 o 


如 果 你 还 不 确定 你 的 lighttpd 版 本 的 话 ， 你 可 以 在 命令 行 中 使 
用 lighttpd -V 查 看 相应 的 版 本 信息 。 


Note: 较 早 版 本 的 lighttpd 可 能 会 按照 不 同 的 方式 组 织 .conf 文 件 ， 但 是 它们 应 该 遵循 
的 是 相同 的 原则 。 


ligghttpd 在 Debian GNU/Linux 下 的 配置 文件 


Files and Directories in /etc/lighttpd: 


lighttpd.conf: 
main configuration file 


conf -available/ 


This directory contains a series of .conf files. These file 
configuration directives necessary to load and run webserve 
If you want to create your own files they names should be 
build as nn-name.conf where "nn" is two digit number (numb: 
is used to find order for loading files) 


conf -enabled/ 
To actually enable a module for lighttpd, it is necessary ! 
symlink in this directory to the .conf file in conf-availal 


Enabling and disabling modules could be done by provided 
/usr/sbin/lighty-enable-mod and /usr/sbin/lighty-disable-mod script 
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对 于 web py ， 你 需要 允许 mod fastcgi 模块 和 mod _rewrite 模 块 , 运行 : 
/usr/sbin/lighty-enable-mod 局 用 fastcgi (Mac OS X 可 能 不 需要 ) 
(mod rewrite 模块 可 能 需要 启用 10-fastcgi.conf 文件 ). 


下 面 是 文件 的 基本 结构 (Mac OS X 不 同 ) : 


e /etc/lighttpd/lighttpd.conf 
e /etc/lighttpd/conf-available/10-fastcgi.conf 
e code.py 


对 于 Mac OS X 或 任何 以 Mac Ports 邓 方式 安装 的 lighttpd， 可 以 直接 在 路 径 下 编 
写 .conf 文 件 并 用 lighttpd -f xxx.conf 启 动 lighttpd， 而 无 需 去 修改 或 考虑 任何 文件 结 
构 。 


/etc/lighttpd/lighttpd.conf 


server .modules = ( 
"mod_access", 
"mod_alias", 
"mod_accesslog", 
"mod_compress", 


) 


server .document - root = "/path-to/webpy-app" 


对 我 来 说 ， 我 使 用 postgresql， 因 此 需要 授予 对 的 数据 库 权 限 ， 可 以 添加 行 如 下 
(如 果 不 使 用 则 不 需要 ) 。 


server.username = "postgres" 


/etc/lighttpd/conf-available/10-fastcgi.conf 


+= ( "mod_fastcgi" ) 


server.modules 
+= ( "mod_rewrite" ) 


server.modules 


fastcgi.server = ( "/code.py" => 
(( "socket" => "/tmp/fastcgi.socket", 
"bin-path" => "/path-to/webpy-app/code.py", 
"max-procs" => 1, 
"bin-environment" => ( 
"REAL SCRIPT NAME" => "" 


Do 
"check-local" -» "disable" 


)) 
) 


如 果 本 地 的 1ighttpd 跑 不 起 来 的 话 ， 需 要 设置 Check-1ocal 属 性 为 disable。 


url.rewrite-once = ( 
"A/favicon.ico$" => "/static/favicon.ico", 


"A/static/(.*)$" => "/static/$1", 
"A/(.*)$" => "/code.py/$1", 


/code.py 在 代码 头 部 添加 以 下 代码 ， 让 系统 环境 使 用 系统 环境 中 当前 的 python 


#!/usr/bin/env python 
最 后 不 要 忘记 了 要 对 需要 执行 的 py 代码 设置 执行 权限 ， 否 则 你 可 能 会 遇 
到 “permission denied” 错 误 。 


$ chmod 755 /path-to/webpy-app/code.py 
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这 一 节 讲 解 的 是 如 何 使 用 Nginx 和 FastCGI 搭 建 Web.py 应 用 


环境 依赖 的 软件 包 


Nginx 0.8. or 0.7. (需要 包含 fastcgi 和 rewrite 模 块 )。 
Webpy 0.32 

Spawn-fcgi 1.6.2 

Flup 


注意 : Flup 是 最 常见 的 忘记 装 的 软件 ， 需 要 安装 
更 老 的 版 本 应 该 也 可 以 工作 ， 但 是 没有 测试 过 ， 最 新 的 是 可 以 工作 的 


e Nginx wiki 
e Spawn-fcgi 
e Flup 


Notes 


e 你 可 以 重 命名 index.py ou d o 
e /path/to/www 为 代码 路 径 
e /path/to/www/index.py 为 python 代 码 的 完整 路 径 o 


Nginx 配置 文件 


location / { 
include fastcgi_params; 
fastcgi_param SCRIPT_FILENAME $fastcgi_script_name; 
fastcgi_param PATH_INFO $fastcgi_script_name; 
fastcgi_pass 127.0.0.1:9002; 


对 于 静态 文件 可 以 添加 如 下 配置 


# [1] 
# [2] 


location /static/ { 
if (-f $request_filename) { 
rewrite ^/static/(.*)$ /static/$1 break; 


} 


注意 : 地 址 和 端口 号 可 能 会 是 不 同 的 。 


Spawn-fcgi 
可 以 通过 一 下 命令 启动 一 个 Spawn-fcgi 进 程 : 


spawn-fcgi -d /path/to/www -f /path/to/www/index.py -a 127.0.0.1 -[ 


Ee 





启动 和 关闭 的 命令 
启动 : 


#!/bin/sh 
spawn-fcgi -d /path/to/www -f /path/to/www/index.py -a 127.0.0.1 -[ 


4 — 3 


关闭 : 





#!/bin/sh 
kill ^pgrep -f "python /path/to/www/index.py"' 


Note: 你 可 以 随意 卉 写 地 址 和 端口 信息 ， 但 是 一 定 需要 和 Nginx 配 置 文件 相 匹 配 。 


Hello world! 


讲 下 面 的 代码 保存 为 iIndex.py (或 者 任何 你 喜欢 的 ) ， 注 意 ， 使 用 Nginx 配 置 的 
话 ， web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi( func 
这 一 行 代码 是 必须 的 。 


#!/usr/bin/env python 
# -*- coding: utf-8 -*- 


import web 


urls = ("/.*", "hello") 
app - web.application(urls, globals()) 


class hello: 
def GET(self): 
return 'Hello, world!' 


if name == " main "'": 
web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(fur 
app.run() 





注意 : 同样 需要 给 代码 设置 权限 ， 代 码 如 下 chmod +x index.py ° 
运行 


1. 打开 一 个 spawn-fcgi 进程 . 
2. 打开 Nginx. 


如 果 需 要 检查 应 用 程序 是 否 运 行 ， 使 用 ps aux|grep index.py 可 以 很 容 多 的 查 
看 。 


重启 nginx 配 置 : 
/path/to/nginx/sbin/nginx -s reload 
停止 nginx: 


/path/to/nginx/sbin/nginx -s stop 


注意 : 运行 后 可 访问 http://localhost 访 问 网 站 ， 更 多 信息 可 以 去 参考 nginx 官 方 文 
档 。 


CGI deployment on Apache 


Here are the simple steps needed to create and run an web.py application. 
e Install web.py and flups 


e Create the application as documented 


if name == " main_": 
web.run(urls, globals()) 


For our example, let it be named app.py , located in /www/app and we need it 
accessible as http://server/app/app.py . 


e Configure Apache (version 2.2 in this example) 


ScriptAlias /app "/www/app/" 
&lt;Directory "/www/app/"&gt; 

Options +ExecCGI +FollowSymLinks 

Order allow, deny 

Allow from all 
&lt;/Directory&gt; 


That's it. Your application is accessible via http://server/app/app.py/ . 
Additional URLs handled by the application are added to the end of the URL, for 
examples http://server/app/app.py/myurl . 


e .htaccess configuration 


Options +ExecCGI 

AddHandler cgi-script .py 

DirectoryIndex index.py 

&lt;IfModule mod rewrite.c&gt; 
RewriteEngine on 
RewriteBase / 
RewriteCond %{REQUEST_ FILENAME] !-f 
RewriteCond %{REQUEST_ FILENAME) !-d 
RewriteCond %{REQUEST_URI} !^/favicon.ico$ 
RewriteCond %{REQUEST_URI} !4(/.*)+index.py/ 
RewriteRule 4(.*)$ index.py/$1 [PT] 

&lt;/IfModule&gt; 


Here it is assumed that your application is called index.py. The above htaccess 
checks if some static file/directory exists failing which it routes the data to your 
index.py. Change the Rewrite Base to a sub-directory if needed. 
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使 用 Apache + mod wsgi 部 署 webpy 应 用 


下 面 的 步骤 在 Apache-2.2.3 (Red Hat Enterprise Linux 5.2, x86_64),mod_wsgi-2.0 
中 测试 通过 。 ( 译 者 注 : 本 人 在 Windows2003 + Apache-2.2.15 + mod_wsgi-3.0% 
测试 通过 ) 
注意 : 

e 您 可 以 使 用 您 自己 的 项 目 名 称 替 换 'appname' 。 

e 您 可 以 使 用 您 自己 的 文件 名 称 替换 'code.py'。 

e /var/wwwiwebpy-app 为 包含 您 的 code.py 的 文件 夹 目录 路 径 。 

e /Var/www/webpy-app/code.py 是 您 的 python 文 件 的 完整 路 径 。 
步骤 : 

e 下 载 和 安装 mod_wsgi 从 它 的 网 站 : 
http://code.google.com/p/modwsgi/. 它 将 安装 一 个 '.so' 的 模块 到 您 的 apache 模块 文 
TE3 > Pilko : 


/usr/lib64/httpd/modules/ 


e 在 httpd.conf 中 配置 Apache 7» 3 mod wsgi2x fe KAA A: 


LoadModule wsgi module modules/mod wsgi.so 
WSGIScriptAlias /appname /var/www/webpy-app/code.py/ 


Alias /appname/static /var/www/webpy-app/static/ 
AddType text/html .py 


&lt;Directory /var/www/webpy -app/&gt; 
Order deny,allow 
Allow from all 

&lt;/Directory&gt; 


e 演示 文件 'code.py': 


import web 
io hello’, 


class hello: 
def GET(self): 
return "Hello, world." 
application = web.application(urls, globals()).wsgifunc() 
e 在 您 的 浏览 器 地 址 栏 中 输入 ' http://your_server_name/appname' 来 验证 它 是 否 
可 用 。 

itx: mod wsgi + sessions 
如 果 您 需要 在 mod wsgi 中 使 用 Sessions， 您 可 以 改变 您 的 代码 如 下 : 


app = web.application(urls, globals() ) 


curdir = os.path.dirname(__file__) 
session = web.session.Session(app, web.session.DiskStore(curdir + 


application = app.wsgifunc() 





mod wsgi 性 能 : 


A X€mod wsgi 的 性 能 ， 请 参考 mod_ wsgi 的 维基 页 : 
http://code.google.com/p/modwsgi/wiki/PerformanceEstimates 


deploying web.py with nginx and mod wsgi 


It is possible to deploy web.py with nginx using a mod_wsgi similar to the module 
for Apache. 


After compiling and installing nginx with mod wsgi, you can easily get a web.py 
app up and running with the following config* (edit the paths and settings with your 
own): 


wsgi_python_executable /usr/bin/python; 


server { 
listen 80; 
server_name www.domain_name.com domain_name.com; 
root /path/to/your/webpy; 


include /etc/nginx/wsgi_vars; 
location / { 
wsgi_pass /path/to/your/webpy/app.py; 


} 


*Note: This is a snippet of the relevant information to setup mod wsgi for your 
web app and NOT a full config for running nginx. 


Helpful links: nginx website wiki page on mod wsgi 
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这 一 节 讲 解 的 是 如 何 使 用 Nginx 和 FastCGI 搭 建 Web.py 应 用 


环境 依赖 的 软件 包 


Nginx 0.8. or 0.7. (需要 包含 fastcgi 和 rewrite 模 块 )。 
Webpy 0.32 

Spawn-fcgi 1.6.2 

Flup 


注意 : Flup 是 最 常见 的 忘记 装 的 软件 ， 需 要 安装 
更 老 的 版 本 应 该 也 可 以 工作 ， 但 是 没有 测试 过 ， 最 新 的 是 可 以 工作 的 


e Nginx wiki 
e Spawn-fcgi 
e Flup 


Notes 


e 你 可 以 重 命名 index.py ou d o 
e /path/to/www 为 代码 路 径 
e /path/to/www/index.py 为 python 代 码 的 完整 路 径 o 


Nginx 配置 文件 


location / { 
include fastcgi_params; 
fastcgi_param SCRIPT_FILENAME $fastcgi_script_name; 
fastcgi_param PATH_INFO $fastcgi_script_name; 
fastcgi_pass 127.0.0.1:9002; 


对 于 静态 文件 可 以 添加 如 下 配置 


# [1] 
# [2] 


location /static/ { 
if (-f $request_filename) { 
rewrite ^/static/(.*)$ /static/$1 break; 


} 


注意 : 地 址 和 端口 号 可 能 会 是 不 同 的 。 


Spawn-fcgi 
可 以 通过 一 下 命令 启动 一 个 Spawn-fcgi 进 程 : 


spawn-fcgi -d /path/to/www -f /path/to/www/index.py -a 127.0.0.1 -[ 


Ee 





启动 和 关闭 的 命令 
启动 : 


#!/bin/sh 
spawn-fcgi -d /path/to/www -f /path/to/www/index.py -a 127.0.0.1 -[ 


4 — 3 


关闭 : 





#!/bin/sh 
kill ^pgrep -f "python /path/to/www/index.py"' 


Note: 你 可 以 随意 卉 写 地 址 和 端口 信息 ， 但 是 一 定 需要 和 Nginx 配 置 文件 相 匹 配 。 


Hello world! 


讲 下 面 的 代码 保存 为 iIndex.py (或 者 任何 你 喜欢 的 ) ， 注 意 ， 使 用 Nginx 配 置 的 
话 ， web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi( func 
这 一 行 代码 是 必须 的 。 


#!/usr/bin/env python 
# -*- coding: utf-8 -*- 


import web 


urls = ("/.*", "hello") 
app - web.application(urls, globals()) 


class hello: 
def GET(self): 
return 'Hello, world!' 


if name == " main "'": 
web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(fur 
app.run() 





注意 : 同样 需要 给 代码 设置 权限 ， 代 码 如 下 chmod +x index.py ° 
运行 


1. 打开 一 个 spawn-fcgi 进程 . 
2. 打开 Nginx. 


如 果 需 要 检查 应 用 程序 是 否 运 行 ， 使 用 ps aux|grep index.py 可 以 很 容 多 的 查 
看 。 


重启 nginx 配 置 : 
/path/to/nginx/sbin/nginx -s reload 
停止 nginx: 


/path/to/nginx/sbin/nginx -s stop 


注意 : 运行 后 可 访问 http://localhost 访 问 网 站 ， 更 多 信息 可 以 去 参考 nginx 官 方 文 
档 。 


